home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / rswd1111.zip / ROSESYS.TXT < prev    next >
Text File  |  1990-11-18  |  115KB  |  2,601 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                           
  8.                                           
  9.                                           
  10.                                           
  11.                         RATS Open Systems Environment (ROSE)
  12.                                           
  13.                                ROSE X.25 Packet Switch
  14.                                           
  15.                                 System Manager Manual
  16.                                           
  17.                                           
  18.                                           
  19.                                           
  20.                                           
  21.                                          by
  22.                                           
  23.                                Thomas A. Moulton, W2VY
  24.                                           
  25.                                           
  26.                                           
  27.                                           
  28.                                           
  29.                                           
  30.                                           
  31.                                           
  32.                                           
  33.                                           
  34.                                           
  35.                                           
  36.                                           
  37.                                           
  38.                                           
  39.                                           
  40.                                           
  41.                                           
  42.                                           
  43.                                    Distributed by
  44.                                           
  45.                                           
  46.                                           
  47.                                           
  48.                                           
  49.                                   Thomas A. Moulton
  50.                                  150 William Street
  51.                                   Clifton, NJ 07014
  52.                               United States of America
  53.                                           
  54.  
  55.  
  56.  
  57.  
  58.  
  59.      
  60.      Introduction                                               1
  61.      Use Guidelines                                             1
  62.      Notational Syntax                                          1
  63.      Addressing                                                 1
  64.      Routing                                                    2
  65.      Network Definition                                         3
  66.      Network Configuration                                      4
  67.      Configuration of Default Parameters                        5
  68.      Configuration of This Switch                               6
  69.      Configuration of This Switch                               7
  70.      Configuration of Local Switches                            9
  71.      Configuration of Routing Information                      11
  72.      Additional Configuration Commands                         13
  73.      Special Characters to the Configuration Program           13
  74.      ROSE X.25 Packet Switch Applications                      13
  75.      LOADER Application                                        14
  76.      LOADABLE APPLICATIONS                                     16
  77.      BOOTER Application                                        17
  78.      CONFIG Application                                        17
  79.      HEARD Application                                         19
  80.      INFO Applications                                         19
  81.      MHEARD Application                                        20
  82.      MEMSIZ Application                                        20
  83.      USERS Application                                         20
  84.      Running ROSEPWD                                           21
  85.      Running the Configuration Program                         22
  86.      Configuration Program Command Summary and Error Messages  22
  87.      Programming the EPROM                                     22
  88.      Permanent Configuration of the Switch                     25
  89.      Power ON Indications for TNC-2                            26
  90.      Configuring a switch for the first time                   27
  91.      Configuring a switch for the second time                  30
  92.      Configuring a Remote Switch                               30
  93.      Loading a Switch after a Power Failure                    31
  94.      Hardware Installation - TNC-2 or Clone                    31
  95.      Hardware Installation - PacComm DR-100/DR-200             32
  96.      Hardware Modifications - TNC-2 or Clone                   33
  97.      Hardware Modifications - DR-100/DR-200                    33
  98.      Asynchronous Communications                               35
  99.      Asynchronous Radio Port Cables                            37
  100.      Wiring two TNCs for Back-to-Back Operation                37
  101.      Differences between ROSE and Net/ROM Back-to-Back Cable   38
  102.      Wiring many TNCs for Back-to-Back Operation               38
  103.      Conclusion                                                39
  104.      Appendix 1 - Files Supplied in archive                     1
  105.      Appendix 2 - ROSE X.25 Packet Switch User's Manual         1
  106.      Appendix 3 - Network Configuration Example                 1
  107.      Appendix 4 - Terminology                                   1
  108.      Appendix 5 - Shifted ASCII Table                           2
  109.  
  110.  
  111.                                                                         1
  112.  
  113.  
  114.      Introduction
  115.  
  116.                The ROSE  X.25 Packet Switch is an  advanced replacement for
  117.           the common  digipeater or  other node  switching EPROM.  The ROSE
  118.           Switch represents  the state  of  the  art  in  packet  switching
  119.           technology using international standard protocols. It is based on
  120.           the CCITT  X.25 Network  Layer, and  the ARRL  AX.25  Link  Layer
  121.           Protocols.
  122.  
  123.                The ROSE X.25 Packet Switch is the best solution for Amateur
  124.           Packet Radio  Networking.  A  ROSE  Switch  can  be  accessed  by
  125.           standard AX.25 TNCs supporting the AX.25 Link Layer protocol. The
  126.           AX.25 Link  Layer protocol is also used on paths between backbone
  127.           switches. The X.25 Network Layer protocol is used by the switches
  128.           to transfer  the users'  data through the network. See Appendix 2
  129.           (Users Manual) for a complete list of features.
  130.  
  131.      Use Guidelines
  132.  
  133.                The ROSE  switch is  a shareware  product within the Amateur
  134.           Radio Community.  The executable  firmware is available from many
  135.           sources, including many land-line BBSs, as well directly from the
  136.           author. The  switch firmware  may be  used  free  of  charge  for
  137.           amateur radio purposes.
  138.  
  139.                Shareware registration will entitle the user to notification
  140.           of  updates,  information  about  new  applications  as  well  as
  141.           assistance with network coordination. Informational mailings will
  142.           be sent bimonthly. See Appendix 6, ROSE Registration Form.
  143.  
  144.                Answers to  questions,  special  help,  such  as  customized
  145.           EPROMs,  assistance  with  configurations,  can  be  arranged  by
  146.           contacting the author.
  147.  
  148.                Commercial use  of the  ROSE X.25 Packet Switch is expressly
  149.           forbidden.  Contact   the   author   for   commercial   licensing
  150.           information.
  151.  
  152.      Notational Syntax
  153.  
  154.                Words that have the first character capitalized are being
  155.           emphasized and are defined in Appendix 4 Terminology. In examples of
  156.           interactions with the Switch commands you typed are underlined and
  157.           replies from the Switch are bold.
  158.  
  159.      Addressing
  160.  
  161.                The ROSE  X.25 Packet  Switch supports the global addressing
  162.           plan adopted  by CCITT and ISO. This plan includes a country code
  163.           and a  national network  number.  The  ROSE  Switch  follows  the
  164.           numbering plan  in use  in the  national  X.25  packet  switching
  165.           network, most packet networks follow the telephone numbering plan
  166.           used in  that country. North America uses the telephone Area Code
  167.           and Exchange.
  168.  
  169.  
  170.                                                                         2
  171.  
  172.  
  173.                This system  will allow  a user to request a connection with
  174.           another station  without any  concern given to the exact path the
  175.           data will  follow. This  is in  sharp contrast  to the explicitly
  176.           specified approach  used by  digipeaters. The motivation for this
  177.           is that the general user population doesn't care to, or have time
  178.           to, keep  abreast of  the networking  changes  over  time.    The
  179.           routing is  under your  complete control, so users can't clog the
  180.           network with  retries on  obsolete RF  paths. Users  only need to
  181.           know the  Network Address  of the  destination, which  is like  a
  182.           telephone number.
  183.  
  184.                The ROSE  Switch may  be configured  with several  paths  to
  185.           remote Area  Codes or countries. Each of the specified links will
  186.           be tried  in the order they were specified to find an operational
  187.           route. This is an improvement on several existing amateur systems
  188.           which can  only provide  implicit destination routing to switches
  189.           known by the source switch.
  190.  
  191.                The  telephone   exchanges  are   allocated  based   on  the
  192.           population density  of each   area. A single ROSE X.25 Switch can
  193.           provide RF  coverage of  many different exchanges. A full list of
  194.           exchanges that  the switch  should  handle  as  its  own  can  be
  195.           specified.
  196.  
  197.                The addressing  also needs  to support  routing to different
  198.           countries, the  X.121 standard handles this with a prefix country
  199.           code. In  data networks  the country  code  is  called  the  Data
  200.           Network Identification  Code (DNIC),  the ROSE Switch supports up
  201.           to 8  different DNICS, and will be expanded as the networks grow.
  202.           The user  can specify  the DNIC  in the  TNC connect  command  by
  203.           adding an  extra four  digit digipeater  field between the switch
  204.           callsign and  the network  address, for  example  to  connect  to
  205.           VE7APU in Canada you could enter the following command:
  206.  
  207.                     C VE7APU V N2DSY-3,3020,617385
  208.  
  209.                The ROSE  Switch would see the four digit group and the fact
  210.           that another  digit field  followed it  and  merge  the  numbers,
  211.           resulting in an address of 3020617385.
  212.  
  213.                If you get a call from a station that is in a different DNIC
  214.           than the  ROSE Switch you use, it will insert the correct DNIC in
  215.           the digipeater field preceding the network address in the connect
  216.           request. This  insures that  you know  how to reach the user at a
  217.           later date,  as well as providing identification of international
  218.           contacts which  sometimes require  special considerations  by the
  219.           users in the contact.
  220.  
  221.      Routing
  222.  
  223.                The ROSE  X.25 Packet Switch supports a very flexible static
  224.           routing scheme.  The routing  is static  in that  the the routing
  225.           tables are  not automatically  updated in  any  way.  The  normal
  226.           method of  having automatically updated tables is through the use
  227.  
  228.  
  229.                                                                         3
  230.  
  231.  
  232.           of various broadcasts for routing updates, ROSE does not do this.
  233.           Instead the  system manager  should configure the switch with all
  234.           the reasonable paths for a given address. This avoids the problem
  235.           of short  band openings  that provide  routing information but no
  236.           useful data transfer.
  237.  
  238.                When attempting  to route  a call  request the  switch  will
  239.           obtain the  alternative list  for the  address specified from the
  240.           routing table.  The list  contains  a  sequence  of  which  local
  241.           switches can  handle the  call in  order of the preference of the
  242.           path.
  243.  
  244.                The most  preferred switch  that is  not listed  as "Out  of
  245.           Order" will  be sent  the call  request. If  that switch responds
  246.           with a  network level  error, such as "No Path" or "Out of Order"
  247.           the next  path in  the alternative list will be tried. If it runs
  248.           out of alternatives the call will be cleared with a cause of "Out
  249.           of Order".
  250.  
  251.                A switch  will mark  a local  switch as "Out of Order" if it
  252.           can not  establish network  level communications with the switch.
  253.           The  switch   will  be   considered  as  "Out  of  Order"  for  a
  254.           configurable period of time.
  255.  
  256.                A routing  loop can  occur when  a switch  receives  a  call
  257.           request that  it has  already routed  to another  switch. This is
  258.           detected by  the switch  by examining  the following  information
  259.           from the call request packet; Source Network Address, Source Call
  260.           Sign, Destination Call Sign and a random number.
  261.  
  262.                The random  number is  comprised of  an 8  bit call sequence
  263.           number and  an 8  bit random  number. The call sequence number is
  264.           incremented for each new call request a switch handles. If a loop
  265.           is detected  the second  call request  is cleared  with a network
  266.           level error  and the  preceding switch  will then  try  the  next
  267.           alternative.
  268.  
  269.      Network Definition
  270.  
  271.                Designing local  network topology  can be  an art in itself.
  272.           The following  is a good template that can be used to determine a
  273.           first best  guess as  to how  the various  paths should  be used.
  274.           Once you  have a network operational you should try various paths
  275.           to optimize  the traffic flow.  In many cases gut feelings should
  276.           be tried  as there  are things  we all know about RF paths that I
  277.           haven't been able to put into words.
  278.  
  279.                In order  to define  a network of ROSE X.25 Packet Switches,
  280.           perform the following steps:
  281.  
  282.                1) Draw  a network  layout consisting  of switches  and  the
  283.           usable RF paths between each adjacent switch.
  284.  
  285.  
  286.                                                                         4
  287.  
  288.  
  289.                2) Assign  each switch  a callsign and address consisting of
  290.           the telephone  Area Code  and Exchange  of the  location  of  the
  291.           switch.
  292.  
  293.                3) Prioritize  the reliability  of  each  switch's  outbound
  294.           links.   Preferred  paths  should  have  many  of  the  following
  295.           characteristics;  Solid  paths,  low  volume  paths;  high  speed
  296.           channels; and  low contention.  In general the number of emitters
  297.           on a  given frequency should kept low. Hidden transmitters should
  298.           be eliminated.  All the  emitters should  hear  each  other  well
  299.           enough to  cause the  carrier to  be detected  by the  modem. The
  300.           shortest path  between two  points is  the  path  with  the  most
  301.           available band width, not the shortest distance!
  302.  
  303.                4) For  each link list the switches within your network that
  304.           can be  reached. If  a switch  shows up more than once decide the
  305.           order that  they should be used, usually "shortest" to "longest".
  306.           Inter-switch traffic on a user channel should be avoided.
  307.  
  308.                5) Next  decide the  best path  for  traffic  from  switches
  309.           outside your  control should  follow.   These can  be thought  of
  310.           general directions, such as North, South, etc. Usually the inter-
  311.           LAN boundary  is obvious, all you have to do is decide what route
  312.           through your  switches you  want this  foreign traffic to follow.
  313.           This route  is a  good candidate  for a  backbone  channel  on  a
  314.           different band.
  315.  
  316.                When each of these items is defined, you will have completed
  317.           a basic  network design.   The  method is  minimal, but  it  will
  318.           assist you  in understanding the workings of the network when you
  319.           start the  deployment phase.  It will also be helpful when trying
  320.           to debug network problems.
  321.  
  322.      Network Configuration
  323.  
  324.                In a ROSE X.25 Network each switch has a description of what
  325.           the network  looks like from it's point of view. This consists of
  326.           a list  of  switches  that  it  talks  to  directly  and  routing
  327.           information.  The  routing  information  describes  what  network
  328.           addresses each  of the  switches in  the list  can handle. When a
  329.           connect request is received by a switch it must be able to decide
  330.           where the request should be sent next. Connection requests can be
  331.           from either a local user or from another switch.
  332.  
  333.                The configuration  of a  switch is  stored in  a  file  that
  334.           contains four sections. These are:
  335.  
  336.                1) Default Parameters
  337.                2) Information about the switch being configured
  338.                3) A list of switches local to the switch being configured
  339.                4) Routing information, who should handle what addresses
  340.  
  341.                Appendix 4  contains a list of terms that should be reviewed
  342.           to aid in clarity of the descriptions.
  343.  
  344.  
  345.                                                                         5
  346.  
  347.  
  348.                Default Parameters
  349.  
  350.                There are  four switch parameters that can be defaulted, the
  351.           form of the default command is:
  352.  
  353.                DEFAULT par Value
  354.  
  355.                Where the  "par" is one of the following and the value is as
  356.           described.
  357.  
  358.                L3W 1..7
  359.  
  360.                This  configures  the  Level  3  Packet  Window,  much  like
  361.           MAXFRAME for TNC Links.  As noted valid values are 1 through 7.
  362.  
  363.                TimeOut 0..65535
  364.  
  365.                When a  network Link  is not  operational  due  to  a  radio
  366.           failure or  interference a  timer is  started to  keep the switch
  367.           from continuously  trying to  bring up  the link. This is done to
  368.           reduce the  time required to route around a malfunctioning switch
  369.           or path.  The suggested  value is  900 seconds  (15 Minutes), but
  370.           other values  can be  used from  0 to 65535 seconds (18 Hours). A
  371.           realistic minimum value is 3-5 minutes. A lower value could cause
  372.           the call  router to  try a  bad link more than once with the same
  373.           call request.
  374.  
  375.                MaxVC 0..254
  376.  
  377.                This parameter  sets the  number  of  VCs,  or  simultaneous
  378.           connections, that  will be  allowed on  a Link to another switch.
  379.           The recommended  value for this is 20. A special case occurs when
  380.           this statement appears in a USER block statement.
  381.  
  382.                Port 0..4
  383.  
  384.                This defines  which serial  port on  the switch  the Node or
  385.           User is  said to be listening. On a TNC-2 the radio is Port 0 and
  386.           the RS-232 connector is Port 1.
  387.  
  388.                The recommended values for these defaults are:
  389.  
  390.                DEFAULT PORT 0
  391.                DEFAULT TIMEOUT 900
  392.                DEFAULT L3W 4
  393.                DEFAULT MAXVC 20
  394.  
  395.                Include
  396.  
  397.                This  default   parameter  defines   a  directory  that  the
  398.           configuration program  will check  for include  files (*<).  This
  399.           directory is  only checked  if the  included file is not found in
  400.           the current directory.
  401.  
  402.  
  403.                                                                         6
  404.  
  405.  
  406.                DEFAULT Include C:\ROSENET\
  407.  
  408.                Password Protection
  409.  
  410.                To protect  the switch  from being  accessed by unauthorized
  411.           users  the   application  loader  has  password  protection.  The
  412.           password is  contained in an external file that is in the current
  413.           directory or the Default Include directory. The password file has
  414.           two parts,  first is  a decimal  number indicating  how long  the
  415.           correct reply should be and the second part is the password key.
  416.  
  417.                For Example:
  418.  
  419.                1
  420.                ROSEISBESTABCDEFGHIJKLMNOPQRSTUVWXYZ
  421.  
  422.                When you  connect to  LOADER you  will be  presented with  a
  423.           series of 16 hex numbers.
  424.  
  425.                Example:
  426.  
  427.                cmd:C LOADER Via ROSE-3,000000
  428.                *** CONNECTED TO LOADER VIA ROSE-3,000000
  429.                Call being setup
  430.                Call Completed to LOADER @ 3100000000
  431.                ROSE X.25 Packet Switch Version 901026 by Thomas A. Moulton,
  432.           W2VY
  433.                03 04 1D 22 05 10 19 08 1A 11 18 02 09 01 20 1F
  434.                E
  435.                OK
  436.  
  437.                Since the reply length is one, you only need to reply to the
  438.           first number.  It is  important to  note that the first character
  439.           (the "R"  of ROSE  in this  case) is counted as 00. Therefore the
  440.           correct reply  is "E".  If the reply length is configured as zero
  441.           (0) then no password is required.
  442.  
  443.                The default  is to  have  No  password.  The  supplied  file
  444.           (PASSWORD.RS) has the example given above as a sample. A password
  445.           will also  be configurable  in the  EPROM in  future releases  of
  446.           MAKEPROM.EXE.
  447.  
  448.                A handy  utility to  print a table for reply key look up can
  449.           be made using ROSEPWD.EXE. See the description of it for details.
  450.  
  451.  
  452.                                                                         7
  453.  
  454.  
  455.                Information about the switch being configured
  456.  
  457.                The first  thing that  must be done is a declaration of what
  458.           country this  switch is  in.  This is done with the DNIC command,
  459.           which has the form:
  460.  
  461.                THIS DNIC 3100 United States of America
  462.  
  463.                The THIS  command is used on the beginning of a statement to
  464.           identify that  the rest  of the  line is  for the  switch that is
  465.           being configured.
  466.  
  467.                The 3100  is the  country code  for the  USA within the data
  468.           networks. A  complete list of DNICs can be found in Appendix C of
  469.           the ROSE  X.25 Packet Switch Users Manual, which is in Appendix 2
  470.           of this manual.
  471.  
  472.                Once this  is done  you can  define the internal information
  473.           about the  switch being  configured. Again we use the THIS prefix
  474.           to identify we are talking about the switch being configured.
  475.  
  476.                THIS NODE Clifton
  477.  
  478.                The NODE  statement is  a Block Statement that is terminated
  479.           with an END statement.
  480.  
  481.                Note: The  location name, Clifton in this case, is only used
  482.           within the configuration file, not on the air. This name must not
  483.           have any  spaces or  commas in  it. Little Falls, NJ is listed as
  484.           LittleFalls.
  485.  
  486.                Each switch  must have  a Network  Address, this  is what is
  487.           used to reference the switch as the destination of a Call Request
  488.           from anywhere in the network.
  489.  
  490.                ADDRESS 201478
  491.  
  492.                The address  can be  from 1 to 6 digits long and must follow
  493.           the national  numbering plan  in use for the X.25 network. In the
  494.           United States  of America  this must  be the  Area Code and local
  495.           Exchange of the location of the switch.
  496.  
  497.                In order  for users and other switches to establish Links to
  498.           this switch it must have an Amateur callsign.
  499.  
  500.                CALL W2VY-3
  501.  
  502.                CALL is  short for  CALLSIGN in this case. The EPROM default
  503.           for the  callsign is  ROSE-3. When  this  callsign  is  used  for
  504.           switching requests, all network level messages will be displayed.
  505.           These messages  include connection setup status, and notification
  506.           reset conditions that could have lost some information.
  507.  
  508.  
  509.                                                                         8
  510.  
  511.  
  512.                Each switch  also has  a  callsign  that  can  be  used  for
  513.           digipeating, this  may be  the same  as  the  CALL.  The  default
  514.           digipeat callsign  is ROSE-2.  If the  CALL and DIGI are the same
  515.           they both still need to be specified. If a switching request uses
  516.           this callsign  there will  be no  additional messages inserted by
  517.           the network  during data transfer, if there is a chance that data
  518.           was lost  due to  a reset  the connection  will be cleared. It is
  519.           strongly  suggested  that  BBS  forwarding  use  this  method  of
  520.           establishing connections.  If the  CALL and  DIGI  are  the  same
  521.           callsign, the messages will always be disabled.
  522.  
  523.                DIGI W2VY-2
  524.  
  525.                If a  switch has  a RF  coverage that  crosses more than one
  526.           telephone exchange then these extra exchanges can be specified in
  527.           the  COVERAGE  statement.  This  is  a  Block  Statement  and  is
  528.           terminated with  an END.  This is  an example  of a  nested block
  529.           statement, we are still in the "This Node Clifton" Block.
  530.  
  531.                COVERAGE
  532.                201472 201473 201777 201779 201470 201478
  533.                201778 201772
  534.                END
  535.  
  536.                Each of  the Network  Addresses listed above will be treated
  537.           as if they were the switch Network Address, 201478 in this case.
  538.  
  539.                When a  Call Request is received that has this switch as the
  540.           destination, address  201478 or  one in  the Coverage  list,  the
  541.           switch will  attempt to establish a Link with the specified user.
  542.           If the  switch is  running on  multi-port  hardware,  such  as  a
  543.           PacComm DR-200  there are  times when  you need  to specify which
  544.           Port the  users are resident on. The USERPORT statement specifies
  545.           which Port should be used to establish Links to users. On a TNC-2
  546.           the Radio  port is  port 0. On a PacComm DR-100 the radio port is
  547.           port 1.
  548.  
  549.                USERPORT 0
  550.  
  551.                A user  can connect  to the switch and get information about
  552.           how to use the network, or other information of general interest.
  553.           This is  specified in a TEXT block, which is ended with "$EOF". A
  554.           blank line is inserted by having a "$" on a line by itself.
  555.  
  556.           TEXT
  557.           $
  558.           While Disconnected From THIS X.25 Switch issue a command like:
  559.           $
  560.           C CALLSIGN-SSID V W2VY-3,201256
  561.           $
  562.                        Switches Available for User Access are:
  563.                Address   Callsign   Location             User Port Freq
  564.                 201256   W2VY-3     Montclair              221.11 Mhz
  565.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  566.  
  567.  
  568.                                                                         9
  569.  
  570.  
  571.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  572.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  573.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  574.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  575.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  576.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  577.           $
  578.           Possible connect paths available to access BBS User ports.
  579.           C KB1BD-4 V W2VY-3,609426   :   C WA2VXT-4 v W2VY-3,609426
  580.           C KD6TH-4 V W2VY-3,201744   :   C N2ELC-4 v W2VY-3,201663
  581.           $
  582.           Connect Paths Available to KA-Nodes or TheNET Facilities:
  583.           C WB2DRD-3 V W2VY-3,609426  :   C WB2MNF-3 V W2VY-3,609530
  584.           $
  585.           When connecting  to TheNet  Nodes act  as if  you have  connected
  586.           direct to  it.   Type C  NODENAME, after  you have  connected  to
  587.           either of  the TheNet  nodes listed above, to connect to the next
  588.           desired node. Type NODES to get a node list after your connect or
  589.           type Info to get information about the particular TheNet node you
  590.           are connected to. Example:  To connect to ELK TheNet node use the
  591.           following sequence:
  592.           C WB2DRD-3 V W2VY-3,6o9530
  593.           C ELK
  594.           $
  595.           You will  shortly be  Disconnected from  this switch.  If you are
  596.           currently connected  via either  TheNET or  KA-Node RECONNECT  to
  597.           THAT node  and then issue a connect as shown above.  Note: It has
  598.           come to our attention that those systems using old TNC1 code will
  599.           not accept  all digit  fields, substitute  o for 0 and i for 1 in
  600.           the all digit field and you will be successful.  Disconnect codes
  601.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  602.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  603.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  604.           $EOF
  605.  
  606.                This connect TEXT can be up to 2048 bytes long.
  607.  
  608.                To terminate  the definition  of the  Clifton Node  the  END
  609.           statement is used, completing the block statement.
  610.  
  611.                END
  612.  
  613.                Local Switches
  614.  
  615.                The next  section describes  the switches  that this  switch
  616.           communicates with directly.
  617.  
  618.                NODE Manhattan
  619.                ADDRESS 212456
  620.                PATH KD6TH-3
  621.                END
  622.  
  623.                This defines  a local  switch that  has the callsign KD6TH-3
  624.           and network  address 212456 and is located in Manhattan. Based on
  625.  
  626.  
  627.                                                                         10
  628.  
  629.  
  630.           the current  defaults it is also on PORT 0 with a link timeout of
  631.           15 Minutes and can support up to 20 calls. Each call will operate
  632.           with a level 3 packet window of 4.
  633.  
  634.                For the  purposes of  this description  we will  also define
  635.           three other local switches.
  636.  
  637.                NODE LittleFalls
  638.                ADDRESS 201744
  639.                PATH N2DSY-3
  640.                END
  641.  
  642.                NODE Clifton2
  643.                ADDRESS 201779
  644.                PATH W2VY-9
  645.                PORT 1
  646.                END
  647.  
  648.                NODE Montclair
  649.                ADDRESS 201256
  650.                PATH W2VY-12 Via KB1BD-2
  651.                END
  652.  
  653.                Each  of  these  are  pretty  standard  with  the  following
  654.           exceptions.     Clifton2  is  on  PORT  1,  which  would  be  the
  655.           asynchronous port  if we  are running  on a  TNC-2 and  that port
  656.           could be  connected to either a modem and radio or a back to back
  657.           cable to  another TNC.  Montclair has a digipeater specified, the
  658.           path to a switch can include up to ONE digipeater.
  659.  
  660.                If you  have a  special device  that is  not on the USERPORT
  661.           channel you  can configure  it in  the switch  as a USER. If this
  662.           USER is not an X.25 Pad (ie it's a TNC or TheNet/NetROM) you must
  663.           specify MAXVC 0.
  664.  
  665.                USER KD6THbbs
  666.                PATH KD6TH-4
  667.                PORT 1
  668.                MAXVC 0
  669.                END
  670.  
  671.                If a  call came  in for  KD6TH-4 with  a switch  address  of
  672.           201478 the  switch would attempt to establish the link on Port 1,
  673.           as was specified. This can be done for any AX25L2 device, such as
  674.           a TheNet or NetROM, as well as a BBS. Users are not encouraged to
  675.           be placed  on the  backbone. If  using a  TNC-2  you  would  just
  676.           specify the  address of the switch that had the radio port on the
  677.           backbone. This  feature is used mostly when the switch is running
  678.           a PacComm DR-200, or other multi-port synchronous device.
  679.  
  680.  
  681.                                                                         11
  682.  
  683.  
  684.                Routing Information
  685.  
  686.                The route  statements specify  what local switches should be
  687.           given calls for which network addresses.  This is usually divided
  688.           into two  parts, first  specifying the  routing  needed  for  the
  689.           switches within  the local network (the switches you control) and
  690.           the second  specifying  the  routing  for  out  of  area  network
  691.           addresses.
  692.  
  693.                The general form of the ROUTE statement is:
  694.  
  695.                ROUTE TO NODES node-list
  696.                CALLS FOR
  697.                network-address-list
  698.                END
  699.  
  700.                Where "node-list"  is a  sequence of switches; and "network-
  701.           address-list" is a list of Network Addresses. The network address
  702.           is  composed   of  the  current  DNIC  followed  by  the  address
  703.           specified. If  the command  "DNIC 0"  is entered then there is no
  704.           DNIC added  to the  address, this  is useful  to route  an entire
  705.           country or continent.
  706.  
  707.                If a  Call Request  is received  for one of the addresses in
  708.           the list the switch will use this routing information to pass the
  709.           Call to the next switch. The switches are tried in the order they
  710.           are listed, so the best route should be listed first, worse last.
  711.           It has  been done  this way  because by  and large  there  are  a
  712.           limited number  of ways  to get  from this  switch  to  a  remote
  713.           region. From the Clifton switch I can route calls for New England
  714.           to Manhattan  or Little  Falls, so  the following statement would
  715.           set up the required routing entries.
  716.  
  717.                Route to Nodes Manhattan LittleFalls
  718.                Calls for
  719.                207 802 617 508 413 203 401
  720.                518 607 212 718 716 516 914 315
  721.                end
  722.  
  723.                I also included the Area Codes for New York.
  724.  
  725.                We also  need to  include the routes for the local switches.
  726.           The routing  information here  should include the address of each
  727.           switch as well as the addresses in it's coverage.
  728.  
  729.                Route to Node Manhattan
  730.                Calls for
  731.                212456
  732.                end
  733.  
  734.                Route to Node LittleFalls
  735.                Calls for
  736.                201744
  737.                end
  738.  
  739.  
  740.                                                                         12
  741.  
  742.  
  743.                As well as addresses to the south and west:
  744.  
  745.                Route to Node LittleFalls
  746.                Calls for
  747.                609 215 717 202
  748.                end
  749.  
  750.                There are files included with the distribution diskette that
  751.           have the Area Codes for the entire USA,  broken down by state and
  752.           call district,  see NPA.ARC.  These files  can  be  placed  in  a
  753.           separate directory  and included in the configuration with the *<
  754.           command.
  755.  
  756.                To include  routing information for other countries you will
  757.           need to  add routing  information for their DNIC's. To facilitate
  758.           this you can have a command such as;
  759.  
  760.                DNIC 0
  761.  
  762.                Which will allow routing statements to include the DNIC;
  763.  
  764.                Route to Nodes LittleFalls Manhattan
  765.                Calls for
  766.                3020 7
  767.                end
  768.  
  769.                This will  add routing  information for all calls to Canada,
  770.           which is  DNIC 3020,  as well  as South  America, where all DNICs
  771.           start with a 7.
  772.  
  773.                Now that  we have  defined the  configuration of a switch we
  774.           need to  create, and  save to  disk, the file that the switch can
  775.           understand. The WRITE statement is used to create this file.
  776.  
  777.                WRITE w2vy-3.tbl
  778.  
  779.                The file  naming conventions  that we use here in NJ are the
  780.           statements that  were used  in the  example are  stored in a file
  781.           with the  name CallSign.CNF  and the output is stored in the file
  782.           CallSign.TBL. (".CNF" Configuration; ".TBL" Table)
  783.  
  784.                The last  statement of  each .CNF  file should  be a QUIT to
  785.           tell the  configuration program  to terminate  and return  to the
  786.           operating system.
  787.  
  788.  
  789.                                                                         13
  790.  
  791.  
  792.      Additional Configuration Commands
  793.  
  794.                If you  are having problems figuring out an error, it can be
  795.           helpful to  see the commands that the program is reading. You can
  796.           cause the  configuration program  to print  each statement  as it
  797.           reads it in by including a VERIFY statement.
  798.  
  799.                VERIFY
  800.                ... statements causing problems...
  801.                NOVERIFY
  802.  
  803.                The NOVERIFY  statement turns this feature off, there can be
  804.           any number of VERIFY/NOVERIFY statements in a configuration file.
  805.  
  806.      Special Characters to the Configuration Program
  807.  
  808.                Any line  in the  configuration file (.CNF) that starts with
  809.           an asterisk  (*) is  treated as a comment, which can be useful to
  810.           indicate extra  information about  a switch, such as equipment at
  811.           the location, access rules, failure history, etc.
  812.  
  813.                There is  one exception,  if a  line starts  with  "*<"  the
  814.           configuration program will treat the text on the rest of the line
  815.           as a  file name.  The program  will expect  the file to be in the
  816.           current directory  or the  directory  specified  in  the  Default
  817.           Include statement. The contents of the file will be read in as if
  818.           it had  been in  the main file. If the file is not found an error
  819.           message will be printed.
  820.  
  821.                The file  that is being read in can not have another "*<" in
  822.           it, this  may be  revised in  later versions of the configuration
  823.           program.
  824.  
  825.                Route to Nodes Manhattan LittleFalls
  826.                Calls for
  827.                *<w1.npa
  828.                *<ny.npa
  829.                end
  830.  
  831.                This would  be the  same as  the previous example of routing
  832.           the calls  for New England and New York, using the supplied files
  833.           in NPA.ARC.
  834.  
  835.      ROSE X.25 Packet Switch Applications
  836.  
  837.                A  Switch   Application  is   a  special   type  of  network
  838.           destination, like  a BBS  is a  special callsign that you connect
  839.           to. Once  connected to it you can issue commands and get replies.
  840.           The following  sections describe  the existing  applications  and
  841.           list any commands and example replies.
  842.  
  843.                To connect to a switch application you would follow the same
  844.           procedure that  you would  to connect  to a  user, but instead of
  845.           entering a user's callsign you enter the name of the application.
  846.  
  847.  
  848.                                                                         14
  849.  
  850.  
  851.           If your  local switch is W2VY-3 and you want to interact with the
  852.           MEMSIZ application at network address 201478, you would issue the
  853.           following connect command:
  854.  
  855.                C MEMSIZ Via W2VY-3,201478
  856.  
  857.                This is  a standard ROSE X.25 Packet Switch connect request.
  858.           The local  switch would route the Call Request to the switch with
  859.           the network address 201478. When a switch receives a Call Request
  860.           it first  checks to see if the destination "callsign" matches any
  861.           of the currently loaded applications. If the application is found
  862.           the switch  would set  up connection with the application. If the
  863.           application was  not loaded  it would  assume that it was a local
  864.           user and attempt a connect on the userport.
  865.  
  866.                Once connected  to the  MEMSIZ application you would get the
  867.           ROSE banner:
  868.  
  869.           ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  870.  
  871.                This would  indicate that the connection is complete and you
  872.           could start interacting with that switch.
  873.  
  874.                The applications  that  accept  commands  currently  use  an
  875.           obscure format that has the general form:
  876.  
  877.                :ccoollll[dd]xx
  878.  
  879.                Where:
  880.  
  881.                cc   is a command number
  882.                00   is an object number
  883.                llll is the length of any optional data
  884.                dd   is the data if the length is non-zero
  885.                xx   is the checksum of the data field
  886.  
  887.                The only  applications that  support data  fields are LOADER
  888.           and CONFIG.  The commands for these are generally stored in files
  889.           created  by   programs  such   as  the   configuration   compiler
  890.           (CONFIGUR.EXE).   All other  commands are  simply single commands
  891.           that end  with  six  zeros.    These  will  be  listed  with  the
  892.           description  of   each  application.  In  future  releases  these
  893.           commands will  be replaced with easier to remember plain language
  894.           commands.
  895.  
  896.      LOADER Application
  897.  
  898.                The LOADER application is resident in the EPROM, this means
  899.           it is always present. As you may be able to guess from the name,
  900.           it is used to load other programs into the switch. This will
  901.           allow you to chose which switches will have what functions.
  902.  
  903.                The files with the filename extension ".LOD" are files that
  904.           can be sent to this application, which will cause the specific
  905.  
  906.  
  907.                                                                         15
  908.  
  909.  
  910.           application to be loaded into memory. The file "CONFIG.LOD" when
  911.           sent (ASCII/TEXT upload) to LOADER would cause the CONFIG
  912.           application to be loaded into memory.
  913.  
  914.                When loading a .LOD file you should get three "OK"'s back,
  915.           the only other message you could get would be "Error n" where N
  916.           is a numeric value indicating what type of error occurred, the
  917.           following table lists the possible error numbers.
  918.  
  919.                Error #   Meaning
  920.                01        Invalid command
  921.                02        Invalid Object
  922.                03        Unable to allocate memory for program
  923.                04        Incorrect checksum
  924.                09        Length mismatch of code segment in .LOD file
  925.                0C        Can't delete non-existent application
  926.                0D        Need to load code segment before relocation info
  927.                0E        To many applications loaded, max is 15
  928.                0F        Unsupported object
  929.                10        Unsupported command
  930.  
  931.                LOADER also supports two other commands:
  932.  
  933.                List Applications ":0000000000"
  934.  
  935.                This command will cause the switch to list all the
  936.           applications that are currently loaded into the memory. When the
  937.           switch is first powered on the list will look like this:
  938.  
  939.                Entry #0 LOADER - Application Boot interface
  940.                OK
  941.  
  942.                If the switch has all the applications loaded into memory
  943.           then the list might look like this:
  944.  
  945.           Entry #0 LOADER - Application Boot interface
  946.           Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...
  947.           Entry #2 USERS  - ROSE Switch User List Display, Version 1.0
  948.           Entry #3 MEMSIZ - ROSE Memory Utilization Display
  949.           OK
  950.  
  951.                The entry # is just the position in the list that the
  952.           application is listed, this number is only important when you are
  953.           using the Delete command.
  954.  
  955.                Delete Application ":02ee000000"
  956.  
  957.                This command will remove an application from memory, thus
  958.           freeing the memory to be used for other things such as data
  959.           buffers or additional connections. The "ee" is the entry number
  960.           the application is in the list.
  961.  
  962.  
  963.                                                                         16
  964.  
  965.  
  966.                Lets say you want to delete the CONFIG application from a
  967.           switch, first you would connect to the LOADER and then list the
  968.           applications:
  969.  
  970.           :0000000000
  971.           Entry #0 LOADER - Application Boot interface
  972.           Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration Interf...
  973.           Entry #2 USERS  - ROSE Switch User List Display, Version 1.0
  974.           Entry #3 MEMSIZ - ROSE Memory Utilization Display
  975.           OK
  976.  
  977.                Notice that the CONFIG application is in entry #1 this time,
  978.           you would enter the following command, replacing the "ee" with
  979.           "01".
  980.  
  981.           :0201000000
  982.           OK
  983.                You could then verify that it was done by entering the list
  984.           command again. The "OK" does tell you that it was in fact done,
  985.           but we'll check anyway, you don't have to check.
  986.  
  987.           :0000000000
  988.           Entry #0 LOADER - Application Boot interface
  989.           Entry #1 USERS  - ROSE Switch User List Display, Version 1.0
  990.           Entry #2 MEMSIZ - ROSE Memory Utilization Display
  991.           OK
  992.  
  993.                Note that all other applications moved up in the application
  994.           list.
  995.  
  996.                When you are done interacting with the LOADER you just
  997.           disconnect.
  998.  
  999.                In addition to accepting the commands described and the
  1000.           ".LOD" files, the LOADER will also accept a ".TBL" file. When a
  1001.           .TBL file is sent to the LOADER the only item that will get
  1002.           updated is the INFO Text (Connect TEXT). You will receive 10
  1003.           "Error 000F" messages and one OK, this is the correct response to
  1004.           a .TBL file and the Error's will not cause any problems. If you
  1005.           do not like getting the "Error 000F" messages you can edit the
  1006.           ".TBL" file and just send the text load command. To do this just
  1007.           take from the ":0100" to the end of the file and store it in a
  1008.           separate file. This was done because the Connect Text is the only
  1009.           configurable information that is not saved in battery backed up
  1010.           memory and allows easy restoration of that information.
  1011.  
  1012.      LOADABLE APPLICATIONS
  1013.  
  1014.                The ROSE  X.25 Packet  Switch EPROM  has  been  designed  to
  1015.           maintain all  functions necessary for packet switching within the
  1016.           ROSE EPROM.  In order to provide for the various User and Network
  1017.           Manager interfaces  and functions  the EPROM  can accept programs
  1018.           loaded  through  the  network.  A  description  of  the  existing
  1019.           applications can be found in the following sections.
  1020.  
  1021.  
  1022.                                                                         17
  1023.  
  1024.  
  1025.      BOOTER Application
  1026.  
  1027.                The BOOTER  Application can  be used to fake a power failure
  1028.           on a  remote switch.  The switch  will be initialized immediately
  1029.           upon receiving the BOOTER.LOD file. When the file has been loaded
  1030.           into the  switch you will get a "*** Disconnect *** 00E9" or some
  1031.           other abnormal  termination. This  action will  indicate that the
  1032.           switch  was   re-initialize,   it   should   maintain   all   the
  1033.           configuration information. It should act as if the power had been
  1034.           removed.
  1035.  
  1036.      CONFIG Application
  1037.  
  1038.                The CONFIG  application is  not designed to be used directly
  1039.           by the switch manager. It is just an interface that processes the
  1040.           file created by the Network Configuration Program (CONFIGUR.EXE).
  1041.           This section  will describe  the interface  for completeness, and
  1042.           there may  be times  when you  might want  to check  some of  the
  1043.           settings.   All replies  are in  hexadecimal and  are not easy to
  1044.           interpret. As  with  the  LOADER  interface  every  command  will
  1045.           generate either  an "OK"  or "Error n" when the processing of the
  1046.           command is  complete, the  meaning of  each of  the errors are as
  1047.           follows:
  1048.  
  1049.                Error #   Meaning
  1050.                01        Invalid command
  1051.                02        Invalid Object specified
  1052.                03        No working memory!
  1053.                04        Bad checksum!
  1054.                05        Unsupported Command
  1055.                06        Odd number of data bytes for type
  1056.                07        Item is Read-Only
  1057.  
  1058.                For 0D object only:
  1059.                01        No working memory
  1060.                02        Invalid DNIC
  1061.  
  1062.                The commands have the same format as the LOADER commands.
  1063.  
  1064.                The following commands are currently supported:
  1065.  
  1066.                #    Function
  1067.                01*  Write new information for object
  1068.                02   Read current value of object
  1069.                
  1070.                NOTE: IT IS NOT RECOMMENDED THAT USERS USE THE 01 COMMAND!
  1071.  
  1072.                The following data objects are supported:
  1073.  
  1074.           00   This object contains the TEXT that a user can access if they
  1075.                connect directly to the switch and hit return.
  1076.  
  1077.           01   This is the list of callsigns of other switches and special
  1078.                users configured via the PATH statement Node and User
  1079.  
  1080.  
  1081.                                                                         18
  1082.  
  1083.  
  1084.                configuration blocks. It also contains the CALL of this
  1085.                switch.
  1086.  
  1087.           02   These are digipeater callsigns that optionally appeared in
  1088.                the "via" field of the PATH statement of Node and User
  1089.                configuration blocks. It also contains the DIGI callsign of
  1090.                this switch.
  1091.  
  1092.           03   These are the PORT numbers of the Node and User
  1093.                configuration blocks.
  1094.  
  1095.           04   These are the MAXVC limits specified in the Node and User
  1096.                configuration blocks. This limits the number of simultaneous
  1097.                network connections that can occur between the this switch
  1098.                and the switch of the Node configuration block. This is also
  1099.                used in the User configuration block to indicate that it is
  1100.                a local AX25L2 user, and when found in a User block must be
  1101.                0.
  1102.  
  1103.           05   These set the L3W for the connections going through a
  1104.                network link, valid values are 1-7.
  1105.  
  1106.           06   These set the TIMEOUT value for a failed network link. This
  1107.                is the time it will be considered Out of Order when it
  1108.                fails, ie it gets a "Retry count exceeded".
  1109.  
  1110.           07   This sets the USERPORT which is used for connecting to
  1111.                AX25L2 users, this can be overridden by User configuration
  1112.                blocks.
  1113.  
  1114.           08   This contains the node address of this switch.
  1115.  
  1116.           09*  This contains the default level 2 parameters for AX25L2
  1117.                connections. (Maxframe, Paclen, Resptime, Frack, Retry)
  1118.  
  1119.           0A*  This contains the default level 2 parameters for X.25
  1120.                Network links.
  1121.  
  1122.           * -  In some versions it produces a pointer to the structure.
  1123.  
  1124.           0B   This object is used in conjunction with the routing tables.
  1125.                This contains a compressed set of routing alternatives,
  1126.                since by and large the various routes and back-up routes are
  1127.                common for getting out of the local network.
  1128.  
  1129.           0C   This contains the routing tables for all the DNICs.
  1130.  
  1131.  
  1132.                                                                         19
  1133.  
  1134.  
  1135.      HEARD Application
  1136.  
  1137.                The HEARD  application gives  a very complete summary of the
  1138.           activity within  the network.  It started out as a simple listing
  1139.           of stations  heard and  then developed  into an important tool in
  1140.           monitoring network activity.
  1141.  
  1142.                It provides the following information:
  1143.  
  1144.                * Source and Destination Callsigns
  1145.                * Full AX.25 Path
  1146.                * Count of valid frames heard
  1147.                * Frame Type of last frame heard
  1148.                * Time since the last frame was heard
  1149.                * Time since the station was first heard
  1150.  
  1151.                A typical display:
  1152.  
  1153.           ROSE X.25 Packet Switch Version 901026 by Thomas A. Moulton, W2VY
  1154.           
  1155.           Heard List for W2VY-9  3100813989
  1156.                                      Last   First (How long ago)
  1157.           Port Station   Destination Heard  Heard  RXCnt FType Path
  1158.             0  W2VY      HEARD       00:00  00:00      4   I   W2VY-9,813989
  1159.             0  K0ZXF     TPALAN      00:00  28:38    117  UI   USF*
  1160.             0  W4DPH     MAIL        00:03  05:55     17  UI
  1161.             0  W4DPH-4   NODES       00:04  03:59      5  UI
  1162.             0  KC2FF-7   ID          00:07  73:25    443  UI
  1163.             0  KC2FF-7   NODES       00:09  03:07     24  UI
  1164.             0  W4DPH-15  W2VY        00:09  01:09     16 SABM
  1165.             0  W4DPH-4   ID          00:13  74:48    345  UI
  1166.             0  W8DUW     TPALAN      00:16  03:39     14  UI   USF*
  1167.             0  N4OJU-6   K0ZXF       00:36  03:35     24 DISC
  1168.             0  CLW5      KB4VHS-15   00:58  01:23     17  UA
  1169.             0  KB4VHS    DABQSO      00:59  01:00      5 SABM  N4EEB-5,904677
  1170.             0  KB4VHS    KB4T        01:01  01:03      5 SABM  N4EEB5,904677
  1171.             0  N4HKA     WA1GUD      01:03  02:08    100  UA
  1172.             0  WA1GUD    N4HKA       01:03  02:08    109 DISC
  1173.           END>
  1174.                
  1175.  
  1176.                Once connected  to HEARD just hit return and it will provide
  1177.           a screen  full of  heard stations. For a longer display enter "*"
  1178.           followed by return and it will list 32 entries.
  1179.  
  1180.      INFO Applications
  1181.  
  1182.                The INFO Application can be used to display the connect text
  1183.           of a  remote switch. The text is the same that would be displayed
  1184.           if you  were to  connect directly  to the  switch and hit return.
  1185.           This application also adds text messages to the *** Reset *** and
  1186.           ***  Disconnect   ***  network  messages  that  give  an  english
  1187.           description of the reason for the message.
  1188.  
  1189.  
  1190.                                                                         20
  1191.  
  1192.  
  1193.                There are  also other  versions of  the INFO  Application to
  1194.           provide Reset  and Disconnect  messages from other languages. The
  1195.           ".LOD" files will have names in the following format:
  1196.  
  1197.                INFO??.LOD
  1198.  
  1199.                Where the ?? denoted the language
  1200.  
  1201.                SP - Spanish
  1202.                DE - German
  1203.                FR - French*
  1204.                RU - Russian*
  1205.  
  1206.                * - In progress - Not yet supplied in the ZIP archive.
  1207.  
  1208.      MHEARD Application
  1209.  
  1210.                The MHEARD  Application is a stripped down version of HEARD.
  1211.           It just shows the callsigns of the heard stations.
  1212.  
  1213.      MEMSIZ Application
  1214.  
  1215.                The MEMSIZ  application was  just a  test program  for me to
  1216.           verify correct  operation of the loader. It turns out that it can
  1217.           be useful  to monitor  the amount of memory that is being used by
  1218.           the switch  from time  to time. This information is also included
  1219.           in the  USERS application  display.  The  values  are  listed  in
  1220.           hexadecimal.
  1221.  
  1222.           Memory Size is: 7578
  1223.           Memory Used is: 4155
  1224.  
  1225.      USERS Application
  1226.  
  1227.                The USERS  application is  used to  list the  users that are
  1228.           currently using  the  switch;  connected  to  a  local  user/bbs;
  1229.           passing  through  to  another  switch;  or  interacting  with  an
  1230.           application that has been loaded. Once you are connected just hit
  1231.           return to view the current status of the connections.
  1232.  
  1233.           ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1234.           [You Press Return]
  1235.           
  1236.           User List for N2DSY-3   3100201744
  1237.           
  1238.           W2VY     AX25L2 User Linked to USERS     @ 3100201744
  1239.           W2VY     AX25L2 User Linked to LOADER    @ 3100201744
  1240.           W2VY-3    X.25 Trunk (R1) with the following connections:
  1241.           KD6TH-4   @ 3100201256     ( 20 P4 D1) <-- KB1BD-5   @ 3100609443
  1242.           WB2JQR-3  X.25 Trunk (R1) with the following connections:
  1243.           KB1BD-5   @ 3100609443     ( 20 P4 D1) --> KD6TH-4   @ 3100201256
  1244.           
  1245.           There are no calls Pending.
  1246.           
  1247.  
  1248.  
  1249.                                                                         21
  1250.  
  1251.  
  1252.           The Following X.25 Trunks are listed as Out of Order:
  1253.           <None> - All Links Operational
  1254.           
  1255.                The first line identifies the callsign and address of the
  1256.           switch that the display is for.
  1257.  
  1258.                The second section shows all active connections. The first
  1259.           connection is my station connected to the USERS application (its
  1260.           how I generated the above display). The second connection is my
  1261.           station connected to the LOADER application. Note that a
  1262.           connection that is listed as "AX25L2 User" is a user directly
  1263.           connected to that switch.
  1264.  
  1265.                Now things start to get interesting, W2VY-3 is another ROSE
  1266.           X.25 Packet Switch and it has one VC. The VC is between KB1BD-5
  1267.           at address 609443 and KD6TH-4 at 201256, these are two BBSs doing
  1268.           forwarding.
  1269.  
  1270.                In this case neither BBS is local so the call also shows up
  1271.           on a second X.25 Trunk. The arrow indicates the direction that
  1272.           the connect request went in, ie. KB1BD-5 called KD6TH-4.
  1273.  
  1274.                Note that this connection shows up twice, once to enter the
  1275.           switch and once to leave. If a user was using the switching
  1276.           function to connect to a station on the same switch there would
  1277.           be two entries listed as AX25L2 Users.
  1278.  
  1279.                A pending call is a connect request that came in while the
  1280.           trunk, or link, to the required switch was not ready. A Call is
  1281.           left in the pending state while the Switch attempts to bring the
  1282.           link into the ready state (R1).
  1283.  
  1284.                If a link to a switch is not operational then it is marked
  1285.           as being Out of Order for a specified time (HH:MM:SS).
  1286.  
  1287.       Running ROSEPWD
  1288.  
  1289.                The ROSEPWD.EXE  program can  be used  to create a table for
  1290.           looking up the correct reply for the password to LOADER.
  1291.  
  1292.                Where file is the name of the password file.
  1293.  
  1294.                To direct the output to the printer:
  1295.  
  1296.                C>ROSEPWD /H file >prn
  1297.  
  1298.  
  1299.                                                                         22
  1300.  
  1301.  
  1302.      Running the Configuration Program
  1303.  
  1304.                You should  run this  program  after  you  have  created  or
  1305.           modified the  configuration file  (.CNF) for a switch. It is used
  1306.           the generate  the file  that gets  uploaded (TEXT/ASCII)  to  the
  1307.           switch CONFIG application, which is described elsewhere.
  1308.  
  1309.                To invoke  the program you insure the program (CONFIGUR.EXE)
  1310.           is in the current directory, or is in the MS-DOS path.
  1311.  
  1312.                C>CONFIGUR w2vy-3.CNF
  1313.                ROSE Interactive Network Monitor by W2VY
  1314.                Largest displacement used = 48
  1315.  
  1316.                Done!
  1317.                C>
  1318.  
  1319.                The message  "Largest Displacement  Used" is  a reference on
  1320.           the size of the routing table and as the routing table grows this
  1321.           number will  change. Any  errors will  be distinctive by starting
  1322.           with "***" with an arrow (^) pointing to the line with the error.
  1323.  
  1324.                If you do not specify the input filename (W2VY-3.CNF in this
  1325.           case) or  if the  file you  specified did  not exist, you will be
  1326.           prompted for the file name.
  1327.  
  1328.                C>CONFIGUR
  1329.                ROSE Interactive Network Monitor by W2VY
  1330.                Node data file name? w2vy-3.cnf
  1331.                Largest displacement used = 48
  1332.  
  1333.                Done!
  1334.                C>
  1335.  
  1336.      Configuration Program Command Summary and Error Messages
  1337.  
  1338.                Please ask me for this, I really need to fill this in.
  1339.  
  1340.      Programming the EPROM
  1341.  
  1342.                The files  distributed that  contain Z80 executable have the
  1343.           file extension  ".OVR". The  file "ROSEZSW.OVR" contains the ROSE
  1344.           X.25 Packet  Switch code  and the  other files are initialization
  1345.           routines for the various packet controllers.
  1346.  
  1347.                The MS-DOS  program "MAKEPROM.EXE"  can be  used to create a
  1348.           binary image or Intel Hex file for a specific TNC.
  1349.  
  1350.                If you need to burn an EPROM and do not have access to a MS-
  1351.           DOS machine  see the  note at  the end of this section as well as
  1352.           the following section.
  1353.  
  1354.  
  1355.                                                                         23
  1356.  
  1357.  
  1358.                The machine models currently supported are:
  1359.  
  1360.                TNC2.OVR   TAPR TNC-2, PacComm TNC-200, Tiny-2, Micropower-2
  1361.                           AEA PK-80, MFJ 1270, 1278 and any TNC-2 Clone
  1362.  
  1363.                DR200.OVR  PacComm DR-200 Dual/DR-100 Single Port Repeater
  1364.  
  1365.                TNC320.OVR PacComm TNC-320 HF Packet Controller
  1366.  
  1367.                PK88.OVR   AEA PK-88 VHF Packet Controller
  1368.  
  1369.                If you  do not  have access to a programmer you can obtain a
  1370.           pre-programmed EPROM from the author.
  1371.  
  1372.                Use the  MAKEPROM.EXE program  to  create  the  file  to  be
  1373.           programmed into  the EPROM.  This program will allow modification
  1374.           of all default parameters, Callsigns, and addresses.
  1375.  
  1376.                Each of  the parameters  is listed on the display and can be
  1377.           modified by  entering the  command followed by the new value. The
  1378.           screen will then be updated to insure that the desired action was
  1379.           taken.
  1380.  
  1381.           C>MAKEPROM
  1382.  
  1383.           ROSE Z80 X.25 Packet Switch EPROM Creation Program
  1384.           
  1385.           TNC type TNC2.OVR   SWitch ROSEZSW.OVR   OUTput ROSEZSW.BIN
  1386.           output MODE BINary   (BINary | HEX)
  1387.           
  1388.           CALLsign = ROSE-3   DIGIpeat call = ROSE-2   ADDress = 3100000000
  1389.           
  1390.           L2FRack 5   L2RESptime 3   L2CHeck 300   L2RETry 8   L2MAXframe 4
  1391.           L3FRack 5   L3RESptime 2   L3CHeck 600   L3RETry 8   L3MAXframe 3
  1392.           
  1393.                    PORT 0 (5 Pin Din)       PORT 1 (DB25/DE9)
  1394.           
  1395.           TX Delay (0TXDelay)   400 ms.     (1TXDelay)   400 ms.
  1396.           DWait    (0DWait)       0 ms.     (1DWait)       0 ms.
  1397.           FULLdup  (0FULL)      OFF         (1FULL)      OFF
  1398.           
  1399.           Type OK to accept the current settings or,
  1400.           QUIT (all CAPS) to exit to DOS
  1401.           To make changes, type the command followed by the new value
  1402.           Type the portion of the command that is in CAPS.
  1403.           
  1404.           EPROM>
  1405.                
  1406.  
  1407.  
  1408.                                                                         24
  1409.  
  1410.  
  1411.                All of  the parameters can be specified on the command line,
  1412.           as identified in the following list:
  1413.  
  1414.           C>MAKEPROM /HELP
  1415.  
  1416.           
  1417.           usage:
  1418.            C:\X25\LEVEL3\MAKEPROM.EXE [options]
  1419.           
  1420.           Options are as follows:
  1421.              /HELP        - PRINT THIS LIST!
  1422.              /NODISPLAY   - Supress menu selection screen
  1423.              /MODE=BIN    - Format of OUTput file. See /HEX and /BIN
  1424.              /HEX         - Output file in Intel Hex format
  1425.              /BINary      - Output file in Binary Image format
  1426.              /SWitch=name - Switch Overlay from file name
  1427.              /CALL=ROSE-3 - EPROM Callsign of Switch
  1428.              /DIGI=ROSE-2 - EPROM Digi Callsign
  1429.              /ADDress=3100000000 - X.121 Address of switch
  1430.              /TNC=TNC2    - Machine type, TNC2 | TNC320 | DR200 | PK88
  1431.              /OUTput=name - Put output in file name
  1432.              /0TXDelay=ms - TXDelay (in MS) for Port 0 (Radio)
  1433.              /1TXDelay=ms - TXDelay (in MS) for Port 1 (Terminal)
  1434.              /0DWait=ms   - DWait (in MS) for Port 0
  1435.              /1DWait=ms   - DWait (in MS) for Port 1
  1436.              /0FULL       - Set Port 0 for Full Duplex operation
  1437.              /1FULL       - Set Port 1 for Full Duplex operation
  1438.              /L2FRack     - FRack (T1) for Level 2 Users
  1439.              /L2RESptime  - RESptime (T2) for Level 2 Users
  1440.              /L2CHeck     - CHeck (T3) for Level 2 Users
  1441.              /L2RETry     - RETry (N2) for Level 2 Users
  1442.              /L2MAXframe  - MAXframe (W) for Level 2 Users
  1443.              /L3FRack     - FRack (T1) for X.25 Networking Trunks
  1444.              /L3RESptime  - RESptime (T2) for X.25 Networking Trunks
  1445.              /L3CHeck     - CHeck (T3) for X.25 Networking Trunks
  1446.              /L3RETry     - RETry (N2) for X.25 Networking Trunks
  1447.              /L3MAXframe  - MAXframe (W) for X.25 Networking Trunks
  1448.           
  1449.             IF TNC=TNC320 or TNC=PK88 then the following are valid:
  1450.           
  1451.                   /CPU=4915200    - CPU Clock frequency in HERTZ
  1452.                   /TICK=1200      - Frequency of clock on SYNCB or CTSB
  1453.                   /0BAUD=1200     - Radio Baud Rate
  1454.                   /1BAUD=9600     - Terminal Baud Rate
  1455.                   /LEDS=4         - Initial LED bit pattern
  1456.           
  1457.             IF TNC=TNC320
  1458.           
  1459.                   /MODEM=HF | VHF - Specify which modem should be used.
  1460.           
  1461.           NOTE: It is important to include the DNIC in the /ADDRESS.
  1462.                 The DNIC  for USA is 3100, so an address of 201779 would be
  1463.                 entered as /ADDRESS=3100201779.
  1464.  
  1465.  
  1466.                                                                         25
  1467.  
  1468.  
  1469.                For example to create a Binary file for a TNC-320 for use on
  1470.           HF at  300 baud  with an  output file  of TNC320HF.BIN  enter the
  1471.           following command:
  1472.  
  1473.           C>MAKEPROM /TNC=TNC320 /MODEM=HF /0BAUD=300 /OUT=TNC320HF.BIN
  1474.  
  1475.                This will still bring up the display for inspection, you may
  1476.           also specify /NODISPLAY to skip the verification screen.
  1477.  
  1478.                NOTE: If  you can not run MAKEPROM.EXE then you will have to
  1479.           perform the  following steps. Load the ROSEZSW.OVR into the EPROM
  1480.           burner in BINARY mode (Will fill locations 0000 to 7FFF) and then
  1481.           load the  .OVR file  for the  machine you  are using (TNC2.OVR or
  1482.           DR200.OVR or TNC320.OVR or PK88.OVR...). This will fill locations
  1483.           0000 to  0150. To make sure everything is OK, you should see FF's
  1484.           at some  locations below 0150H as well as below 7FFF. If you want
  1485.           to modify the default parameters see the following section.
  1486.  
  1487.      Permanent Configuration of the Switch
  1488.  
  1489.                Using the  MAKEPROM program you can modify many of the EPROM
  1490.           default parameters.  See the preceding section for information on
  1491.           using it. If you can not use it then you will have to combine the
  1492.           ".OVR" files  by hand and use the following information to modify
  1493.           the defaults.
  1494.  
  1495.                 The  distribution includes  a ".MAP" file that contains the
  1496.           EPROM address  of all entry points and important variables. Using
  1497.           this information  you can  modify the  default parameters  in the
  1498.           EPROM. The  format of  the data  falls into four forms. A byte, a
  1499.           word, a callsign and a network address.
  1500.  
  1501.                A byte  is simply  a single  location in the EPROM which can
  1502.           hold a value from 00 to FF (that is 0 to 255 decimal).
  1503.  
  1504.                A word  is a  two byte  value with the low order byte of the
  1505.           word stored  at the  lower EPROM  address. A  word can  contain a
  1506.           value from 0000 to FFFF (that is 0 to 65535 decimal). Since it is
  1507.           stored low  byte at low address the value 01 00 is 1 decimal, and
  1508.           00 01 is 256 decimal, or 0100 hexadecimal.
  1509.  
  1510.                A callsign  is stored  in AX.25  format,  the  same  way  it
  1511.           appears in packets sent over the air. Each callsign is a six byte
  1512.           shifted ASCII  callsign followed  by  a  single  byte  SSID,  for
  1513.           example in the EPROM the callsign ROSE-3 would have the following
  1514.           format:
  1515.  
  1516.                A4 9E A6 8A 40 40 06
  1517.  
  1518.                Appendix 5  contains a  table for  conversion  from  and  to
  1519.           shifted ASCII as used in AX.25.
  1520.  
  1521.                A network  address is  stored in  CCITT X.25 address format,
  1522.           which is  a length  byte followed  by a BCD representation of the
  1523.  
  1524.  
  1525.                                                                         26
  1526.  
  1527.  
  1528.           address, for  example  the  address  3100201779  would  have  the
  1529.           following format:
  1530.  
  1531.                0A 31 00 20 17 79
  1532.  
  1533.                Note that  the length  (0A, 10 decimal) is the number of BCD
  1534.           digits, ie "31" is two digits.
  1535.  
  1536.                If you  are outside  the USA  the  numbering  plan  may  use
  1537.           something other  than six  digit codes, if the length is ODD then
  1538.           just pad the last byte with an extra 0, but leave the length ODD.
  1539.           I know  Australia uses  a variable  length  numbering  plan,  the
  1540.           format for  node address  50502 (which  is the  region  code  for
  1541.           Sydney) would be:
  1542.  
  1543.                05 50 50 20
  1544.  
  1545.                Note that  the length  is 5  (50502) and  the last  digit is
  1546.           ignored and should be 0.
  1547.  
  1548.                The following  ".MAP" file  labels identify  the location of
  1549.           the following EPROM defaults:
  1550.  
  1551.                "myaddr"  - Network address of this switch
  1552.                "mycall"  - Callsign of this switch
  1553.                "mydigi"  - Callsign this switch recognized for digipeating
  1554.  
  1555.      Power ON Indications for TNC-2
  1556.  
  1557.           Ensure that  the power  switch is off. Insert the power connector
  1558.           and then turn the power on.
  1559.  
  1560.           The ROSE  X.25 Packet  Switch  has  a  two  phase  initialization
  1561.           sequence.
  1562.  
  1563.           In the  first phase  you should  see the  PWR, CON and STA lights
  1564.           come on  for TWO  (2) seconds  while the  Switch  tests  RAM  and
  1565.           verifies the battery backed up RAM.
  1566.  
  1567.           The second  phase the  CON and STA LEDs are used to indicate what
  1568.           was going  on when the switch was powered off. This indication is
  1569.           displayed for  THREE (3) seconds (they both normally stay on). If
  1570.           they both  go out,  then the  switch was processing data when the
  1571.           power was  removed. When powering a unit as a ROSE Switch for the
  1572.           first time, this display is meaningless.
  1573.  
  1574.           At this  point the  CON and STA lights should alternately turn on
  1575.           and off  once  a  second,  this  indicates  that  the  switch  is
  1576.           operating correctly.
  1577.  
  1578.  
  1579.                                                                         27
  1580.  
  1581.  
  1582.      Configuring a switch for the first time
  1583.  
  1584.                This section  will take you step by step through configuring
  1585.           a switch  for the  first time.  It is  assumed that the ROSE X.25
  1586.           Packet Switch has been installed and you are using a standard TNC
  1587.           on the air to connect to the switch.
  1588.  
  1589.                When a  switch is being installed for the first time it is a
  1590.           good idea  to run  the following  tests. First  you should verify
  1591.           that the  switch can  digipeat frames. Since the default callsign
  1592.           is ROSE-2, set UNPROTO as follows:
  1593.  
  1594.                cmd:unproto test via rose-2
  1595.                cmd:conv
  1596.                Test
  1597.                W2VY>TEST,ROSE-2*:Test
  1598.                
  1599.  
  1600.                The test  frame was digipeated successfully, indicating that
  1601.           the connections to the radio should be ok.
  1602.  
  1603.                Now we should verify that the switching callsign is correct,
  1604.           return to command mode (usually by typing Control-C) and enter:
  1605.  
  1606.                cmd:c rose-3
  1607.                *** CONNECTED to ROSE-3
  1608.                [Hit return or wait 60 Seconds]
  1609.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1610.                *** DISCONNECTED
  1611.                cmd:
  1612.                
  1613.                This is  the default  information  message  and  so  all  is
  1614.           working correctly.
  1615.  
  1616.                The preceding  steps could  have been skipped, but these are
  1617.           strongly suggested  for any packet boards that have undergone any
  1618.           hardware modifications to install the switch.
  1619.  
  1620.                Now we can start the configuration process.
  1621.  
  1622.                At this  point it  is assumed  that  you  have  created  the
  1623.           configuration file  for this  switch (.CNF  file) and have run it
  1624.           through the  CONFIGUR program,  to  create  the  .TBL  file.  See
  1625.           Network Configuration and Running the Configuration Program.
  1626.  
  1627.                The  .TBL   file  needs   to  be   uploaded  to  the  CONFIG
  1628.           Application, See  Switching Applications,  first we  must  verify
  1629.           that the  CONFIG program is loaded in the switch. This is done by
  1630.           connecting to the application LOADER with the following command:
  1631.  
  1632.                cmd:c loader via rose-3,000000
  1633.                *** CONNECTED to LOADER VIA ROSE-3,000000
  1634.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1635.                :0000000000
  1636.  
  1637.  
  1638.                                                                         28
  1639.  
  1640.  
  1641.                Entry #0 LOADER - Application Boot interface
  1642.                OK
  1643.                
  1644.                This display  shows that  none of  the optional applications
  1645.           are loaded.   In  order  to  upload  the  .TBL  file  the  CONFIG
  1646.           application must be resident in memory.
  1647.  
  1648.                To load  the CONFIG  application into  memory  you  need  to
  1649.           upload the  file CONFIG.LOD  to the Loader. This file is an ASCII
  1650.           TEXT file, no special protocol should be used to send the file.
  1651.  
  1652.                You should  receive 3  OK's back  from the  loader. At  this
  1653.           point you can verify that the CONFIG application was successfully
  1654.           loaded by entering the following command:
  1655.  
  1656.                :0000000000
  1657.                Entry #0 LOADER - Application Boot interface
  1658.                Entry #1 CONFIG - ROSE X.25 Packet Switch Configuration...
  1659.                OK
  1660.                
  1661.                We are  now done  loading the  CONFIG  application  and  can
  1662.           disconnect from  the LOADER and connect to CONFIG to complete the
  1663.           configuration process.
  1664.  
  1665.                cmd:disc
  1666.                cmd:*** DISCONNECTED
  1667.                cmd:c config v rose-3,000000
  1668.                *** CONNECTED to CONFIG VIA ROSE-3,000000
  1669.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1670.                
  1671.                We are now connected to the CONFIG application, and can send
  1672.           the .TBL file to it. This file is also an ASCII TEXT file, upload
  1673.           with no special protocol.
  1674.  
  1675.                The CONFIG  application will  return  11  OK's  through  the
  1676.           course of  processing the  file. Later  versions will  include  a
  1677.           message stating that the configuration is complete.
  1678.  
  1679.                When you have gotten all the OK's you can disconnect.
  1680.  
  1681.                cmd:disc
  1682.                cmd:*** DISCONNECTED
  1683.                
  1684.                The configuration  process is  now complete! At this point I
  1685.           usually like  to  verify  that  the  connect  text  was  uploaded
  1686.           correctly, since it is the last portion of the .TBL file.
  1687.  
  1688.  
  1689.                                                                         29
  1690.  
  1691.  
  1692.                Since the switch is now configured you now use the switches'
  1693.           callsign, instead of ROSE-3, which is in this case W2VY-3
  1694.  
  1695.           cmd:c w2vy-3
  1696.           *** CONNECTED to W2VY-3
  1697.           [Hit Return or wait 60 Seconds]
  1698.           ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1699.           
  1700.           While Disconnected From THIS X.25 Switch issue a command like:
  1701.           
  1702.           C CALLSIGN-SSID V W2VY-3,201256
  1703.           
  1704.                        Switches Available for User Access are:
  1705.                Address   Callsign   Location             User Port Freq
  1706.                 201256   W2VY-3     Montclair              221.11 Mhz
  1707.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  1708.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  1709.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  1710.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  1711.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  1712.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  1713.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  1714.                                              
  1715.              Possible connect paths available to access BBS User ports.
  1716.           C KB1BD-4 V W2VY-3,609426           C WA2VXT-4 v W2VY-3,609426
  1717.           C KD6TH-4 V W2VY-3,201744           C N2ELC-4 v W2VY-3,201663
  1718.                                              
  1719.               Connect Paths Available to KA-Nodes or NETROM Facilities:
  1720.           C WB2DRD-3 V W2VY-3,609426          C WB2MNF-3 V W2VY-3,609530
  1721.                                              
  1722.           When connecting  to NETROM  Nodes act  as if  you have  connected
  1723.           direct to  it.   Type C  NODENAME, after  you have  connected  to
  1724.           either of  the netrom  nodes listed above, to connect to the next
  1725.           desired node. Type NODES to get a node list after your connect or
  1726.           type Info to get information about the particular netrom node you
  1727.           are connected to. Example:  To connect to ELK netrom node use the
  1728.           following sequence:
  1729.           C WB2DRD-3 V W2VY-3,6o9530
  1730.           C ELK
  1731.           
  1732.           You will  shortly be  Disconnected from  this switch.  If you are
  1733.           currently connected  via either  NETROM or  KA-Node RECONNECT  to
  1734.           THAT node  and then issue a connect as shown above.  Note: It has
  1735.           come to our attention that those systems using old TNC1 code will
  1736.           not accept  all digit  fields, substitute  o for 0 and i for 1 in
  1737.           the all digit field and you will be successful.  Disconnect codes
  1738.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  1739.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  1740.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  1741.           *** DISCONNECTED
  1742.           cmd:
  1743.  
  1744.                The configuration  process is  now complete.  It is strongly
  1745.           suggested that you do Not leave CONFIG loaded in the switch. This
  1746.  
  1747.  
  1748.                                                                         30
  1749.  
  1750.  
  1751.           is because  it will  help avoid unauthorized access to update the
  1752.           configuration and  the memory can better be used for data buffers
  1753.           for connections.
  1754.  
  1755.      Configuring a switch for the second time
  1756.  
  1757.                The following  example shows  how to configure a switch that
  1758.           knows it's  callsign,  but  otherwise  it  is  identical  to  the
  1759.           preceding example. This will only need to be done if the switch's
  1760.           configuration needs  to be  changed, since  all the  routing  and
  1761.           network information is retained in battery backed up RAM.
  1762.  
  1763.                Since we normally do not keep CONFIG loaded we need to
  1764.           reload the CONFIG application.
  1765.  
  1766.                cmd:c loader v w2vy-3,201478
  1767.                *** CONNECTED to LOADER VIA W2VY-3,201478
  1768.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1769.                :0000000000
  1770.                Entry #0 LOADER - Application Boot interface
  1771.                OK
  1772.                
  1773.                The CONFIG application is NOT loaded, so now you would send
  1774.           the file CONFIG.LOD, it is an ASCII TEXT file.
  1775.  
  1776.                You then get the 3 OK's and disconnect.
  1777.  
  1778.                cmd:d
  1779.                cmd:*** DISCONNECTED
  1780.                
  1781.                cmd:c config v w2vy-3,201478
  1782.                *** CONNECTED to CONFIG VIA W2VY-3,201478
  1783.                ROSE X.25 Switch Version 890820 by Thomas A. Moulton, W2VY
  1784.                
  1785.                Now send the .TBL file and receive 11 OK's, when done
  1786.           disconnect.
  1787.  
  1788.                cmd:d
  1789.                cmd:*** DISCONNECTED
  1790.                cmd:
  1791.                
  1792.                The switch is now reconfigured.
  1793.  
  1794.      Configuring a Remote Switch
  1795.  
  1796.                In an operational network any switch can be loaded from any
  1797.           point within the network. You just need to issue a connect
  1798.           command to your TNC that had the callsign of the local switch,
  1799.           followed by the network address of the switch you wish to
  1800.           interact with.
  1801.  
  1802.                When accessing a completely unconfigured switch remember the
  1803.           default callsign is ROSE-3 and the default address is 000000.
  1804.           This should only happen the first time you bring up a switch, see
  1805.  
  1806.  
  1807.                                                                         31
  1808.  
  1809.  
  1810.           the section Configuring a Switch for the first time for a step by
  1811.           step example. If you notice that the switch fails to remember
  1812.           it's callsign after the power has been removed for a short time,
  1813.           that may indicate that the battery needs replacing. Lithium
  1814.           batteries are usually good for 3 Years - TAPR TNC-2's should be
  1815.           needing new batteries soon!
  1816.  
  1817.                You can also use MAKEPROM to program different callsign and
  1818.           address defaults.
  1819.  
  1820.      Loading a Switch after a Power Failure
  1821.  
  1822.                When a switch or site undergoes a power failure the connect
  1823.           text and any loadable applications are lost. The switch can still
  1824.           perform network routing and switching. You will need to connect
  1825.           to LOADER and send the applications that you normally use
  1826.           (INFO.LOD, HEARD.LOD, etc). The process is the same as loading
  1827.           CONFIG, as shown in the proceeding examples. You may also send
  1828.           the ".TBL" file to reload the connect text. See the description
  1829.           of the LOADER for additional information.
  1830.  
  1831.      Hardware Installation - TNC-2 or Clone
  1832.  
  1833.      Tools  Required:   Small  Philips   screwdriver  and   small  standard
  1834.           screwdriver.
  1835.  
  1836.           Remove power and all external connections to the TNC.
  1837.  
  1838.           Remove the  two philips  screws on the front panel and remove the
  1839.           screw in the heat sink. There is no screw on TNC-2 Rev 1 boards.
  1840.  
  1841.           If the  unit is  an MFJ  remove two  standard screws  on sides of
  1842.           cabinet and remove the lid.
  1843.  
  1844.           Locate the program EPROM, this is normally U23, towards the front
  1845.           of the  packet controller,  next to the Z80 (big 40 pin chip that
  1846.           is 2" long). The EPROM is along side the Z80 and RAMs.
  1847.  
  1848.           The EPROM should be a labeled with something like 1.1.6 (1.1.1 up
  1849.           to 1.1.6).  It should NOT say "STATE 1.09", that EPROM is part of
  1850.           the modem. The program EPROM is U23.
  1851.  
  1852.           When you have located the EPROM note the direction the end with a
  1853.           small notch is pointing. This designates which end pin #1 located
  1854.           on. If  you install  an EPROM backwards you can damage it, either
  1855.           destroying the program or making the EPROM completely unusable.
  1856.  
  1857.           Use the  small standard  screwdriver to  lift the  EPROM a little
  1858.           above the socket.
  1859.  
  1860.           WARNING: Make  SURE you are not lifting the socket off the board.
  1861.           Just put the corner of the screwdriver under the EPROM for now.
  1862.  
  1863.  
  1864.                                                                         32
  1865.  
  1866.  
  1867.           Once the  EPROM is above the surface of the socket you can insert
  1868.           the screwdriver a bit further. Try to lift the EPROM straight up,
  1869.           insert the  screwdriver as  far as it will easily go and lift the
  1870.           EPROM a  little more.  Repeat until the screwdriver is completely
  1871.           under the EPROM.
  1872.  
  1873.           If you bend any of the pins it might be a good idea to leave them
  1874.           alone until it is reused.  (The person erasing/re-programming the
  1875.           EPROM will very likely have experience with bent pins!)
  1876.  
  1877.           Make sure  the socket  is flat  and not lifted on either end from
  1878.           the board.
  1879.  
  1880.           When pressing  the EPROM into the socket it is best to press from
  1881.           the bottom  of the board as well as the on EPROM. If the EPROM is
  1882.           new the  pins will  be spread much wider than the pin rows in the
  1883.           socket. To  better align the pins you can place the EPROM on each
  1884.           edge (pins  on a table) and apply firm pressure while raising the
  1885.           chip portion  to the  vertical position. Do this for both rows of
  1886.           pins.
  1887.  
  1888.           Don't go to far! It is easier to do it again then it is to unbend
  1889.           the pins.
  1890.  
  1891.           Take the  ROSEZSW (ROSE  Z80 SWitch)  EPROM and  install  in  the
  1892.           vacated socket. Ensure the notch is pointed in the same direction
  1893.           as the  old EPROM,  as well as the silhouette on the board. Align
  1894.           both rows of pins and let the EPROM slide in a little, then check
  1895.           for stuck  pins. Slight  pressure on  the side  of each  pin will
  1896.           insure it is started into the socket straight.
  1897.  
  1898.           Go little by little watching for bending pins.
  1899.  
  1900.           After the  EPROM is  installed, check  for bent  pins by  looking
  1901.           under and along the sides for an unusual seating.
  1902.  
  1903.           Make sure  the notch in the new EPROM has the same orientation as
  1904.           the original EPROM.
  1905.  
  1906.           Re-assemble the unit.
  1907.  
  1908.      Hardware Installation - PacComm DR-100/DR-200
  1909.  
  1910.           Read the  installation instructions for the TNC-2, above for some
  1911.           precautions on EPROM handling, removal and insertion.
  1912.  
  1913.           The program EPROM is located at position U2, in the center of the
  1914.           board, near the Z80.
  1915.  
  1916.           See also Hardware Modifications - DR-100/DR-200 for some required
  1917.           changes to the board.
  1918.  
  1919.           The port  that is  next to  the RESET  pin is  SCC Port B, and is
  1920.           called Port 0 by the ROSE Switch.
  1921.  
  1922.  
  1923.                                                                         33
  1924.  
  1925.  
  1926.           DR-100 Note:  You will  need to  change the USERPORT statement in
  1927.           the configuration   file to  be "USERPORT  1" as  the DR-100 only
  1928.           has one  port and  it is set up at the same address as the DR-200
  1929.           Port 1.
  1930.  
  1931.           The daughter  board is  not currently  supported. (It has a TNC-2
  1932.           style modem disconnect so it's the simplest way to attach the NB-
  1933.           9600 High Speed modem)
  1934.  
  1935.      Hardware Modifications - TNC-2 or Clone
  1936.  
  1937.           There are  no modifications  that are required to set up a single
  1938.           port switch, there are a couple of things that would be desirable
  1939.           for a busy switch.
  1940.  
  1941.           These are:
  1942.  
  1943.           1) 32K RAM upgrade
  1944.  
  1945.           2) Change the CPU clock to 4.9 MHz (JMP2 on TNC-2)
  1946.  
  1947.           The following modifications are required if you intend to use the
  1948.           asynchronous port  on a  radio or  tied back to back with another
  1949.           TNC:
  1950.  
  1951.           Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!
  1952.  
  1953.           1) Add  a jumper  from J1  pin 23 to JMP 9 pin 3, note that JMP 9
  1954.           has pins 1, 2 and 3 tied together.
  1955.  
  1956.           2) If you want to run the asynchronous port at 4800 baud or above
  1957.           U3 (LM324) should be changed to a TL084.
  1958.  
  1959.           3) If running back to back with other TNCs add jumper from J1 Pin
  1960.           10 to  J1 Pin 20, this should be done in the cable. If connecting
  1961.           to a  Radio do  not add this jumper, see Wiring TNCs for Back-to-
  1962.           Back Mode for a complete description.
  1963.  
  1964.      Hardware Modifications - DR-100/DR-200
  1965.  
  1966.           There are  two types  of modifications  listed  for  the  DR-200,
  1967.           required and  optional. The  required changes  are to  supply the
  1968.           Transmit and  Receive Clocks  to the  Zilog Serial  Communication
  1969.           Controller (Z8530)  chip, which sets the baud rate for each port,
  1970.           and removal  of the "Processor WatchDog Timer" which was found to
  1971.           be ineffective.  The optional  changes are  modifications to  the
  1972.           modem circuit  that have,  in some  cases  increased  performance
  1973.           dramatically.
  1974.  
  1975.           Note: Ux/n  means chip  marked Ux pin n, on IC's the end with the
  1976.           notch has pin #1. When viewed from the top, pin #1 is just to the
  1977.           left of the notch.
  1978.  
  1979.  
  1980.                                                                         34
  1981.  
  1982.  
  1983.           Note: All  wires should be added to the solder side of the board,
  1984.           do not attach wires to the chip pins!!
  1985.  
  1986.           Required:
  1987.  
  1988.           U14 = 7910 Port A; U15 = 8530 SCC; U16 = 7910 Port B
  1989.  
  1990.           Jumper U14/25 to U15/19
  1991.           Jumper U16/25 to U15/21
  1992.  
  1993.           This connects the DCD outputs of the 7910's to the SCC.
  1994.  
  1995.           The baud rate generator is U12, which is located next to the 7910
  1996.           (U14) on the same side as the Z80.  A jumper is required for both the
  1997.           TX and RX clock of each port, FOUR (4) jumpers should be installed.
  1998.           This allows different baud rates for each port. To select the correct
  1999.           clocks use the following table:
  2000.  
  2001.                U12 Pin   RXClock        TXClock
  2002.                 7        9600
  2003.                 5        4800
  2004.                 4        2400
  2005.                 6        1200
  2006.                13         600
  2007.                12         300           9600
  2008.                14                       4800
  2009.                15                       2400
  2010.                 1                       1200
  2011.                 2                       600
  2012.                 3                       300
  2013.      
  2014.                The SCC Pins are defined as follows:
  2015.  
  2016.                Port #    RXClock        TXClock
  2017.                  0       U15 28         U15 26
  2018.                  1       U15 12         U15 14
  2019.                
  2020.                For dual port operation with both ports running at 1200
  2021.                baud install the following jumpers:
  2022.  
  2023.                U15/28 and U15/12 to U12/6  (RXClock)
  2024.                U15/26 and U15/14 to U12/1  (TXClock)
  2025.                
  2026.                For Port 0 at 1200 Baud and Port 1 at 300 Baud
  2027.                
  2028.                U15/28 to U12/6  (RXClock Port 0)
  2029.                U15/26 to U12/1  (TXClock Port 0)
  2030.                U15/12 to U12/12 (RXClock Port 1)
  2031.                U15/14 to U12/3  (TXClock Port 1)
  2032.  
  2033.           Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!
  2034.  
  2035.           A Processor  Watchdog Timer  is a  circuit that  is  designed  to
  2036.           ensure the  CPU does  not get  hung (dead)  due to a power glitch
  2037.  
  2038.  
  2039.                                                                         35
  2040.  
  2041.  
  2042.           (normally a programmer's bug).  The Processor Watchdog circuit is
  2043.           not compatible  with the normal operation of a ROSE Switch and if
  2044.           it is  not removed  the ROSE  Switch will  operate in  an erratic
  2045.           fashion.
  2046.  
  2047.           Remove U19  located next to one of the audio lines, opposite edge
  2048.           of board  from EPROM.   Also  remove C32 and install U7 (74HC132)
  2049.           with pins  3, 12  and 13 uninserted and add a jumper from U7/3 to
  2050.           U7/12, this  cleans up  the reset  line since the watchdog is now
  2051.           out of the circuit.
  2052.  
  2053.           Optional:
  2054.  
  2055.           Remove the  RX Audio filtering (U17 and U20), the modem will work
  2056.           better on  it's own.  I removed  U17, R21, R23, Diodes at C24 and
  2057.           installed a  0.1 uf at C24 and Jumper JP-FA. And the same for the
  2058.           other port (Remove U20, R34, R33, Diodes at C45 and installed 0.1
  2059.           uf at  C45 and Jumper JP-FB). If you use the modem on HF remember
  2060.           the tones are 425 hz higher (.5 khz on dial should be ok) and you
  2061.           need to reduce the RF Gain so the background static is below 10mv
  2062.           (audio). Might  want to  use the  R33/R30 voltage divider and add
  2063.           jumper from  their junction to the other side of JP-FB and remove
  2064.           C41 and leave JP-FB uninstalled.
  2065.  
  2066.           Note: ALL MODIFICATIONS ARE TO THE BOTTOM (FOIL SIDE)!
  2067.  
  2068.      Asynchronous Communications
  2069.  
  2070.                The ROSE  X.25 Packet  Switch supports the asynchronous port
  2071.           of a  TNC-2 or  Clone as  just another radio port. The goal is to
  2072.           allow connection  to any standard RS-232 device, such as a modem.
  2073.           The RS-232  signals operate  in a  normal  fashion  which  allows
  2074.           connection to  conventional land  line modem, multiplexers or any
  2075.           other communications  equipment  that  is  available  to  provide
  2076.           backbone linking.
  2077.  
  2078.                The immediate  application is connection of a Bell 202 modem
  2079.           and a  radio to  provide a  local backbone for a given area. This
  2080.           type of set up requires half as many TNC's!
  2081.  
  2082.                Two or more switches may also be tied together on the RS-232
  2083.           ports to provide multiple synchronous ports from a single site.
  2084.  
  2085.  
  2086.                                                                         36
  2087.  
  2088.  
  2089.           TNC-2 Asynchronous Port Definition
  2090.  
  2091.           All connections are to J1 (DB 25)
  2092.  
  2093.           Pin #     Direction/EIA Pin Designation/Usage
  2094.            1        NA/Frame Ground
  2095.            2        In/TXD/Data On
  2096.            3        Out/RXD/Data Out
  2097.            5        Out/CTS/Request To Send (Async PTT)
  2098.            7        NA/Ground
  2099.            9        Out/HI/Pull Up Signal (+12 VDC)
  2100.           10        Out/LO/Pull Down signal (-12 VDC)
  2101.           20        In/DTR/If LO wired to a diode matrix cable
  2102.                     . /If not LO wired to a standard RS-232 device
  2103.           23        In/SEL/Carrier Detect
  2104.  
  2105.           PacComm Asynchronous Port Definition
  2106.  
  2107.           All connections are to RS-232 Connector (DE 9)
  2108.  
  2109.           Pin #     Direction/EIA Pin Designation/Usage
  2110.            2        Out/RXD/Data Out
  2111.            3        In/TXD/Data On
  2112.            5        NA/Frame Ground
  2113.            6        Out/DSR/Pull Up Signal (+12 VDC)
  2114.            7        In/DTR/If LO wired to a diode matrix cable
  2115.                     . /If not LO wired to a standard RS-232 device
  2116.            8        Out/CTS/Request To Send (Async PTT)
  2117.            9        In/SEL/Carrier Detect
  2118.  
  2119.           AEA Asynchronous Port Definition
  2120.  
  2121.           All connections are to J1 (DB 25)
  2122.  
  2123.           Pin #     Direction/EIA Pin Designation/Usage
  2124.            1        NA/Frame Ground
  2125.            2        In/TXD/Data On
  2126.            3        Out/RXD/Data Out
  2127.            4        In/DTR/If LO wired to a diode matrix cable
  2128.                     . /If not LO wired to a standard RS-232 device
  2129.            5        Out/CTS/Request To Send (Async PTT)
  2130.            6        Out/DSR/Pull Up Signal (+12 VDC)
  2131.            7        NA/Ground
  2132.            8*       Out/LO/Pull Down signal (-12 VDC)
  2133.           23*       In/SEL/Carrier Detect
  2134.  
  2135.           Note: JP-3 Must be in position B (Toward Front of board) and JP-9
  2136.                 must be soldered ON
  2137.  
  2138.  
  2139.                                                                         37
  2140.  
  2141.  
  2142.      Asynchronous Radio Port Cables
  2143.  
  2144.           TNC-2 to Radio Port Cable
  2145.  
  2146.           CAPS mean TNC, lower means Modem DB25
  2147.  
  2148.           GND PIN  1 - gnd pin  1
  2149.           TXD PIN  2 - rxd pin  3
  2150.           RXD PIN  3 - txd pin  2
  2151.           CTS PIN  5 - rts pin  4 (Radio keying circuit/PTT)
  2152.           DSR PIN  6 - dtr pin 20 (depending on Modem)
  2153.           GND PIN  7 - gnd pin  7 (Optional)
  2154.           DTR PIN 20 - HI PIN   9 (Use RS-232 Signaling)
  2155.           SEL PIN 23 - dcd pin  8 (Tie Modem DCD to sio dcdb)
  2156.  
  2157.           PacComm Packet Controller to Radio Port Cable
  2158.  
  2159.           CAPS mean TNC, lower means Modem DB25
  2160.  
  2161.           RXD PIN 2 - txd pin  2
  2162.           TXD PIN 3 - rxd pin  3
  2163.           GND PIN 5 - gnd pin  1
  2164.           DSR PIN 6 - dtr pin 20 (depending on Modem)
  2165.           DTR PIN 7 - DSR PIN  6 (RS-232 Interface)
  2166.           CTS PIN 8 - rts pin  4 (Radio keying circuit/PTT)
  2167.           SEL PIN 9 - dcd pin  8 (Tie Modem DCD to sio dcdb)
  2168.  
  2169.           AEA TNC to Radio Port Cable
  2170.  
  2171.           CAPS mean TNC, lower means Modem DB25
  2172.  
  2173.           GND PIN  1 - gnd pin  1
  2174.           TXD PIN  2 - rxd pin  3
  2175.           RXD PIN  3 - txd pin  2
  2176.           DTR PIN  4 - DSR PIN  6 (Use RS-232 Signaling)
  2177.           CTS PIN  5 - rts pin  4 (Radio keying circuit/PTT)
  2178.           DSR PIN  6 - dtr pin 20 (depending on Modem)
  2179.           GND PIN  7 - gnd pin  7 (Optional)
  2180.           SEL PIN 23*- dcd pin  8 (Tie Modem DCD to sio dcdb)
  2181.  
  2182.           Note: JP-3 Must be in position B (Toward Front of board) and JP-9
  2183.                 must be soldered ON
  2184.  
  2185.      Wiring two TNCs for Back-to-Back Operation
  2186.  
  2187.           Each of the following will describe a single end of the cable.
  2188.  
  2189.  
  2190.                                                                         38
  2191.  
  2192.  
  2193.           TNC-2 End of a Dual Back to Back Cable
  2194.  
  2195.           CAPS mean this TNC, lower means the other TNC
  2196.  
  2197.           GND PIN  1 ------ gnd
  2198.           TXD PIN  2 ------ rxd
  2199.           RXD PIN  3 ------ txd
  2200.           CTS PIN  5 ------ sel
  2201.           GND PIN  7 ------ gnd
  2202.           DTR PIN 20 ------ (open)
  2203.           SEL PIN 23 ------ cts
  2204.  
  2205.           PacComm Packet Controller End of a Dual Back to Back Cable
  2206.  
  2207.           CAPS mean this TNC, lower means the other TNC
  2208.  
  2209.           RXD PIN 2 ------ txd
  2210.           TXD PIN 3 ------ rxd
  2211.           GND PIN 5 ------ gnd
  2212.           DTR PIN 7 ------ (open)
  2213.           CTS PIN 8 ------ sel
  2214.           SEL PIN 9 ------ cts
  2215.  
  2216.           AEA PK-88 End of a Dual Back to Back Cable
  2217.  
  2218.           CAPS mean this TNC, lower means the other TNC
  2219.  
  2220.           GND PIN  1 ------ gnd
  2221.           TXD PIN  2 ------ rxd
  2222.           RXD PIN  3 ------ txd
  2223.           DTR PIN  4 ------ (open)
  2224.           CTS PIN  5 ------ sel
  2225.           GND PIN  7 ------ gnd
  2226.           SEL PIN 23*------ cts
  2227.  
  2228.           Note: JP-3 Must be in position B (Toward Front of board) and JP-9
  2229.                 must be soldered ON
  2230.  
  2231.      Differences between ROSE and Net/ROM Back-to-Back Cable
  2232.  
  2233.                The ROSE Switch now also supports usage of the Net/ROM style
  2234.           of diode  matrix cable/board.  Follow the normal construction but
  2235.           swap the wires going to Pin 20 and Pin 23.
  2236.  
  2237.      Wiring many TNCs for Back-to-Back Operation
  2238.  
  2239.                There are  two methods for connecting more than two switches
  2240.           back to  back. The diode matrix cable previously used for Net/ROM
  2241.           can be used with a simple change, see above.
  2242.  
  2243.                To use standard RS-232 signals you will need the PacComm RS-
  2244.           232 LAN  card. The advantage of this board is that RS-232 will be
  2245.           more reliable  over long  cable runs  and  it  can  interface  to
  2246.           standard devices  such as  Landline Modems  or multiplexers. This
  2247.  
  2248.  
  2249.                                                                         39
  2250.  
  2251.  
  2252.           can be useful for attaching to "WormHoles" we can find at or near
  2253.           our offices!
  2254.  
  2255.      Conclusion
  2256.  
  2257.                The ROSE  X.25 Packet  Switch is  the most  advanced  packet
  2258.           switch for  amateur packet  networking. The growing collection of
  2259.           features and  use of state of the art protocols enable it to play
  2260.           a key role in the growing Global Amateur Packet Network.
  2261.  
  2262.                This is  just the  first  tool  for  the  RATS  Open  System
  2263.           Environment. Other  projects have  been identified  and  will  be
  2264.           supported by  or supportive  of the  ROSE X.25 Packet Switch. The
  2265.           Radio  Amateur   Telecommunications  Society   is  committed   to
  2266.           development of  state of  the  art  networking  for  the  amateur
  2267.           service.
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.      Appendix 1 - Files Supplied in archive
  2275.           
  2276.           The following files are included in the archive RZSWmmdd.ZIP:
  2277.           (Where mm is the month and dd is the day of the release)
  2278.           
  2279.           PKZIP (tm)   Version 1.01   07-21-89
  2280.           
  2281.           Searching ZIP: RZSW1130.ZIP
  2282.           
  2283.            Length  Method    Date    Time   CRC-32  Attr  Name
  2284.            ------  ------    ----    ----   ------  ----  ----
  2285.              4644  Implode 12-07-89  19:00  5ee71ccd --w  CONFIG.LOD
  2286.             26700  Implode 10-28-89  17:44  6df18d49 --w  CONFIGUR.EXE
  2287.               994  Implode 12-02-89  14:12  7ce9c027 --w  MEMSIZ.LOD
  2288.              4495  Implode 06-05-89  12:16  c935b21f --w  NPA.ARC
  2289.              1450  Implode 04-11-89  00:29  346f00b7 --w  RATSINFO.TXT
  2290.              1015  Implode 04-11-89  00:28  24745c65 --w  RATSMBR.TXT
  2291.              9995  Implode 12-03-89  14:50  b20201eb --w  READZSW.ME
  2292.              3869  Implode 07-24-89  10:40  c28f67ce --w  REGISTER.TXT
  2293.             13298  Implode 12-01-89  10:14  10b63da8 --w  ROSEZSW.LST
  2294.             11612  Implode 12-01-89  10:16  eda5bfdd --w  ROSEZSW.MAP
  2295.              6397  Implode 12-07-89  19:19  8070a669 --w  USERS.LOD
  2296.              1578  Implode 09-12-89  22:13  5c6ff455 --w  W2VY-3.CNF
  2297.              1364  Implode 10-01-89  11:09  d56805df --w  LOCALNET.TXT
  2298.               230  Shrunk  12-02-89  13:11  f97b7011 --w  BOOTER.LOD
  2299.             32749  Implode 12-01-89  10:16  c12e4e64 --w  ROSEZSW.OVR
  2300.               258  Shrunk  12-02-89  21:44  010ab958 --w  TNC2.OVR
  2301.              3768  Implode 12-02-89  13:12  e0b5e234 --w  INFO.LOD
  2302.               257  Shrunk  12-02-89  21:45  9324d93c --w  DR200.OVR
  2303.               301  Shrunk  12-02-89  21:46  fe70954d --w  TNC320.OVR
  2304.               287  Shrunk  12-02-89  21:46  9352a622 --w  PK88.OVR
  2305.             23262  Implode 12-03-89  09:24  165e2ecc --w  MAKEPROM.EXE
  2306.              7166  Implode 12-07-89  18:21  8302ace5 --w  HEARD.LOD
  2307.            ------                                         -------
  2308.            155689                                          22
  2309.           
  2310.           
  2311.           READZSW.ME   - Boot strap information as well as changes from the
  2312.                          previous release.
  2313.  
  2314.           ROSESYS.DOC  - SYSOP Information on installation and
  2315.                          configuration (THIS FILE).
  2316.  
  2317.           ROSEUSER.DOC - User manual for the Switch.
  2318.  
  2319.           CONFIGUR.EXE - IBM PC executable that converts the network
  2320.                          description file (xyz.CNF) to a file that is
  2321.                          loadable into a switch CONFIG application
  2322.                          (xyz.TBL).
  2323.  
  2324.           CONFIG.LOD   - The configuration interface that is executed on
  2325.                          the switch while uploading the ".TBL" file.
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.           MEMSIZ.LOD   - Simple test application, gives you the amount of
  2332.                          memory used.
  2333.  
  2334.           USERS.LOD    - Application that provides the user with a list of
  2335.                          all active connections to or through a switch.
  2336.  
  2337.           INFO.LOD     - Application to access TEXT of remote switch and
  2338.                          also provides text messages for Reset and
  2339.                          Disconnect messages.
  2340.  
  2341.           HEARD.LOD    - Application that keeps track of what stations the
  2342.                          switch has heard. Keeps track of how long ago they
  2343.                          were heard, the first time heard, number of frames
  2344.                          heard and frame type of the last frame heard.
  2345.  
  2346.           NPA.ARC      - Archive that contains all the Area Codes in the
  2347.                          USA and Canada broken down by state/province and
  2348.                          by call area.
  2349.  
  2350.           ROSEZSW.BIN  - Binary image suitable for EPROM programming.
  2351.  
  2352.           ROSEZSW.HEX  - Intel HEX format file suitable for EPROM
  2353.                          programming.
  2354.  
  2355.           ROSEZSW.LST  - Assembly listing to aid the custom modification of
  2356.                          some of the default parameters.
  2357.  
  2358.           ROSEZSW.MAP  - Address map of all entry points and global
  2359.                          variables, useful in custom modification of
  2360.                          default parameters.
  2361.  
  2362.           TNC2.OVR, TNC320.OVR, PK88.OVR, DR200.OVR
  2363.           and
  2364.           ROSEZSW.OVR  - Overlay files used by MAKEPROM.EXE to create the
  2365.                          EPROM for a specific machine.
  2366.  
  2367.           MAKEPROM.EXE - MS-DOS Program used to create EPROM Image to be
  2368.                          burned into an EPROM.
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.      Appendix 2 - ROSE X.25 Packet Switch User's Manual
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.      Appendix 3 - Network Configuration Example
  2381.      
  2382.           DEFAULT PORT 0
  2383.           DEFAULT TIMEOUT 900
  2384.           DEFAULT L3W 4
  2385.           DEFAULT MAXVC 20
  2386.           
  2387.           THIS DNIC 3100 United States of America
  2388.           
  2389.           THIS NODE Clifton
  2390.           ADDRESS 201478
  2391.           CALL W2VY-3
  2392.           DIGI W2VY-2
  2393.           COVERAGE
  2394.           201472 201473 201777 201779 201470 201478
  2395.           201778 201772
  2396.           END
  2397.           USERPORT 0
  2398.           TEXT
  2399.           $
  2400.           While Disconnected From THIS X.25 Switch issue a command like:
  2401.           $
  2402.           C CALLSIGN-SSID V W2VY-3,201256
  2403.           $
  2404.                        Switches Available for User Access are:
  2405.                Address   Callsign   Location             User Port Freq
  2406.                 201256   W2VY-3     Montclair              221.11 Mhz
  2407.                 201744   N2DSY-3    LittleFalls,NJ         145.07 Mhz
  2408.                 609426   KA2VLP-3   Hightstown,NJ          145.07 Mhz
  2409.                 609261   WA3YRI-3   MtHolly,NJ             145.07 Mhz
  2410.                 212456   KD6TH-6    Manhattan,NY           145.07 Mhz
  2411.                 609530   N2EVW-9    Ewing,NJ               221.01 Mhz
  2412.                 609883   N2EVW-8    Trenton,NJ             221.11 Mhz
  2413.                 201663   N2ELC-3    Lake Hopatcong,NJ       145.09 Mhz
  2414.           $
  2415.              Possible connect paths available to access BBS User ports.
  2416.           C KB1BD-4 V W2VY-3,609426           C WA2VXT-4 v W2VY-3,609426
  2417.           C KD6TH-4 V W2VY-3,201744           C N2ELC-4 v W2VY-3,201663
  2418.           $
  2419.               Connect Paths Available to KA-Nodes or NETROM Facilities:
  2420.           C WB2DRD-3 V W2VY-3,609426          C WB2MNF-3 V W2VY-3,609530
  2421.           $
  2422.           When connecting  to TheNet  Nodes act  as if  you have  connected
  2423.           direct to  it.   Type C  NODENAME, after  you have  connected  to
  2424.           either of  the TheNet  nodes listed above, to connect to the next
  2425.           desired node. Type NODES to get a node list after your connect or
  2426.           type Info to get information about the particular TheNet node you
  2427.           are connected to. Example:  To connect to ELK TheNet node use the
  2428.           following sequence:
  2429.           C WB2DRD-3 V W2VY-3,6o9530
  2430.           C ELK
  2431.           $
  2432.           You will  shortly be  Disconnected from  this switch.  If you are
  2433.           currently connected  via either  TheNET or  KA-Node RECONNECT  to
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.           THAT node  and then issue a connect as shown above.  Note: It has
  2440.           come to our attention that those systems using old TNC1 code will
  2441.           not accept  all digit  fields, substitute  o for 0 and i for 1 in
  2442.           the all digit field and you will be successful.  Disconnect codes
  2443.           can be  found on the KB1BD-4 PBBS, filename is DISCO.COD.  Please
  2444.           address questions  to  KB1BD@KB1BD  or  W2VY@KD6TH.  This  switch
  2445.           brought to you courtesy of RATS.  Enjoy 73 Tom W2VY
  2446.           $EOF
  2447.           END
  2448.           
  2449.           NODE Manhattan
  2450.           ADDRESS 212456
  2451.           PATH KD6TH-3
  2452.           END
  2453.           
  2454.           NODE LittleFalls
  2455.           ADDRESS 201744
  2456.           PATH N2DSY-3
  2457.           END
  2458.           
  2459.           NODE Clifton2
  2460.           ADDRESS 201779
  2461.           PATH W2VY-9
  2462.           PORT 1
  2463.           END
  2464.           
  2465.           NODE Montclair
  2466.           ADDRESS 201256
  2467.           PATH W2VY-12 Via KB1BD-2
  2468.           END
  2469.           
  2470.           USER KD6THbbs
  2471.           PATH KD6TH-4
  2472.           PORT 1
  2473.           MAXVC 0
  2474.           END
  2475.           
  2476.           Route to Nodes Manhattan LittleFalls
  2477.           Calls for
  2478.           207 802 617 508 413 203 401
  2479.           518 607 212 718 716 516 914 315
  2480.           end
  2481.           
  2482.           Route to Node Manhattan
  2483.           Calls for
  2484.           212456
  2485.           end
  2486.           
  2487.           Route to Node LittleFalls
  2488.           Calls for
  2489.           201744
  2490.           end
  2491.           
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.           Route to Node LittleFalls
  2498.           Calls for
  2499.           609 215 717 202
  2500.           end
  2501.           
  2502.           DNIC 0
  2503.           Route to Node LittleFalls
  2504.           Calls for
  2505.           3020
  2506.           end
  2507.           
  2508.           WRITE w2vy-3.tbl
  2509.           QUIT
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.      Appendix 4 - Terminology
  2516.  
  2517.                A Link  is a  connection between  two stations,  either  two
  2518.           users, two switches or a user and a switch.
  2519.  
  2520.                A Virtual  Circuit, or  VC is a connection for data transfer
  2521.           between two  users, in a multi-switch networking environment this
  2522.           may involve more than one Link.
  2523.  
  2524.                A Network  Address is  a number  that  identifies  an  entry
  2525.           and/or exit point of the network.
  2526.  
  2527.                A Call  or Call  Request is  what a  user or switch sends to
  2528.           another switch to attempt to set up a VC to the specified Network
  2529.           Address.
  2530.  
  2531.                A Clear  is an  indication  that  a  Call  or  VC  is  being
  2532.           disconnected, a clearing cause is supplied to indicate the reason
  2533.           for the disconnection.
  2534.  
  2535.                A Routing  Alternative is  the list of switches that will be
  2536.           tried when  a Call  Request is  received for  a specific  Network
  2537.           Address.
  2538.  
  2539.                A Block  Statement is a collection of commands that effect a
  2540.           common item  that was  specified  at  the  start  of  the  block.
  2541.           Examples of  Block Statements are NODE and USER, see below. Block
  2542.           Statements can be nested.
  2543.  
  2544.                A TNC-2  Clone includes, but is not limited to the following
  2545.           packet  controllers;   TAPR  TNC-2;   PacComm  TNC-200,   TINY-2,
  2546.           Micropower-2;  AEA   PK-80;  MFJ  1270,  1278  and  is  generally
  2547.           identifiable has a TNC having a Z80 CPU and Z80 SIO/0.
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.             Appendix 5 - Shifted ASCII Table
  2554.                             Character Hex Value   Shifted
  2555.                                A         41        82
  2556.                                B         42        84
  2557.                                C         43        86
  2558.                                D         44        88
  2559.                                E         45        8A
  2560.                                F         46        8C
  2561.                                G         47        8E
  2562.                                H         48        90
  2563.                                I         49        92
  2564.                                J         4A        94
  2565.                                K         4B        96
  2566.                                L         4C        98
  2567.                                M         4D        9A
  2568.                                N         4E        9C
  2569.                                O         4F        9E
  2570.                                P         50        A0
  2571.                                Q         51        A2
  2572.                                R         52        A4
  2573.                                S         53        A6
  2574.                                T         54        A8
  2575.                                U         55        AA
  2576.                                V         56        AC
  2577.                                W         57        AE
  2578.                                X         58        B0
  2579.                                Y         59        B2
  2580.                                Z         5A        B4
  2581.                                0         30        60
  2582.                                1         31        62
  2583.                                2         32        64
  2584.                                3         33        66
  2585.                                4         34        68
  2586.                                5         35        6A
  2587.                                6         36        6C
  2588.                                7         37        6E
  2589.                                8         38        70
  2590.                                9         39        72
  2591.                              space       20        40
  2592.             
  2593.             Additional values used for SSID's only
  2594.             
  2595.                                10        -         74
  2596.                                11        -         76
  2597.                                12        -         78
  2598.                                13        -         7A
  2599.                                14        -         7C
  2600.                                15        -         7E
  2601.